Oracle VM VirtualBox 5.1.22 Programming Guide and Reference

• 语言: 英语
• 格式: .pdf
• 来源: download.virtualbox.org

摘要

文档系统介绍了Oracle VM VirtualBox的编程接口（Main API），包括如何通过该API创建、配置和管理虚拟机。文档详细描述了IMachine接口的属性和方法，如硬件版本、CPU配置、内存管理等，并提供了不同语言（如Java、Python、C++）和平台下的接口实现示例。此外，文档还涵盖了API的版本兼容性问题及变化日志，确保开发者能够顺利迁移和适配不同版本。

AI总结

### 《Oracle VM VirtualBox 5.1.22 Programming Guide and Reference》 总结

#### 1. **概述**
- **模块化结构**：VirtualBox 分为内核模式、用户空间代码和 API 层（Main API）。Main API 是开发者控制 VirtualBox 的核心接口，提供创建、配置、启动、停止和删除虚拟机等功能。
- **Main API**：完全文档化，支持多种语言调用（如 Java、Python、PHP、C 等），并提供编程接口和枚举类型。

#### 2. **环境特定说明**
- **WebService 调用**：
- **OOWS（面向对象WebService）**：适用于 Java、Python 和 PHP。
- **Raw WebService**：适用于其他语言，提供基于 Axis 的 Java 示例和 Perl 示例。
- **COM/XPCOM 直接调用**：
- 支持 Python、C++、Visual Basic 和 C 等语言。
- 提供 COM API 和事件队列处理。
- **C 绑定**：通过 `VBoxCAPIGlue` 动态库实现，提供初始化和卸载 API，避免平台依赖问题。

#### 3. **基本 VirtualBox 概念**
- **虚拟机信息**：获取虚拟机的硬件版本、UUID、CPU 数量、内存大小等属性。
- **虚拟机配置**：支持 CPU 热插拔、内存气球化、页面融合等功能。
- **虚拟机操作**：包括启动、挂起、恢复快照等操作，部分方法已从 `IConsole` 移动到 `IMachine`。

#### 4. **类接口（Interfaces）**
- **IMachine**：核心接口，用于管理虚拟机配置，包括硬件设置、CPU、内存、存储设备等。
- **IDisplay**：管理虚拟机显示输出，支持远程输出目标（如 RDP）。
- **IDirectory**：处理虚拟机存储目录，支持读取目录项和关闭目录。
- **IFramebuffer**：表示虚拟机的帧缓冲区，用于图形输出。

#### 5. **主要 API 变更日志**
- **版本 5.x**：`ProcessCreateFlag::NoProfile` 重命名为 `ProcessCreateFlag::Profile`，语义发生变化。
- **版本 5.0**：将快照相关方法从 `IConsole` 移动到 `IMachine`，调整参数列表。
- **版本 2.2 和 2.1**：记录了其他不兼容的 API 变更。

#### 6. **总结**
- VirtualBox 提供强大且灵活的编程接口，支持多种语言和应用场景。
- 开发者可以通过 Main API 和相关工具（如 C 绑定）实现对虚拟机的全面控制。
- 注意 API 变更和版本兼容性，确保代码在不同版本中的稳定性。