Oracle VM VirtualBox 5.2.0_BETA1 Programming Guide and Reference

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

摘要

文档详细介绍了Oracle VM VirtualBox 5.2.0_BETA1的编程指南和参考手册。VirtualBox提供了全面的第三方开发者支持，其软件开发工具包（SDK）包含所有必要的文档和接口文件，用于编写与VirtualBox交互的代码。VirtualBox采用模块化设计，分为多个层次，核心是控制虚拟机执行的hypervisor。其上层的API层（称为“Main API”）暴露了虚拟化引擎的全部功能，开发者可以通过该API创建、配置、启动、停止和删除虚拟机，获取运行虚拟机的性能统计信息，并配置VirtualBox安装。文档还详细说明了各种接口和类，如IMachine、IDirectory、IDisplay等，以及它们的方法和属性。

AI总结

《Oracle VM VirtualBox 5.2.0_BETA1 Programming Guide and Reference》文档主要介绍了VirtualBox的软件开发工具包（SDK），重点围绕其API层（Main API）的使用和功能展开。以下是核心内容和关键信息的总结：

1. **SDK概述**
VirtualBox SDK为第三方开发者提供了全面的支持，包含文档和接口文件，便于开发者编写与VirtualBox交互的代码。

2. **VirtualBox的模块化架构**
VirtualBox采用模块化设计，分为多个层次：
- **Hypervisor**：位于底层，是虚拟化引擎的核心，负责管理虚拟机的执行，确保它们与主机及其他虚拟机无冲突。
- **内部模块**：如RDP服务器、Live Migration和Resource Monitor等，提供额外功能。
- **API层（Main API）**：位于最上层，暴露了虚拟化引擎的全部功能，开发者可通过该API编程控制VirtualBox。

3. **Main API的功能**
Main API允许开发者执行以下操作：
- 创建、配置、启动、停止和删除虚拟机。
- 获取运行中虚拟机的性能统计信息。
- 配置VirtualBox安装。
API的详细文档见第5章（类/接口）和第6章（枚举）。

4. **关键API接口示例**
- **IMachine::getUSBControllerCountByType**：获取虚拟机中指定类型的USB控制器数量。
- **IMachine::hotPlugCPU**和**IMachine::hotUnplugCPU**：动态插入或移除CPU。
- **IMachine::launchVMProcess**：启动虚拟机进程，支持多种前端（如GUI、Headless等）。
- **IDirectory**和**IDisplay**：分别用于管理目录和处理虚拟机的显示输出。
- **IBandwidthControl**：管理虚拟机的带宽组，控制网络和磁盘I/O。

5. **错误处理与特殊接口**
- 文档列举了可能的错误代码，如`VBOX_E_OBJECT_NOT_FOUND`。
- **IVirtualBoxSDS**：仅在Windows主机上可用，用于解决Microsoft (D)COM的设计缺陷。

6. **其他功能与扩展**
- **IVirtualSystemDescription**：用于描述虚拟系统（机器），支持从OVF文件导入虚拟机。
- **IFramebufferOverlay**：管理覆盖层的显示属性，如位置和透明度。

总结：该文档详细介绍了VirtualBox SDK的核心功能，特别是Main API的使用方法，涵盖虚拟机管理、性能监控、错误处理等多个方面，为开发者提供了全面的编程参考。