Oracle VM VirtualBox R ⃝ Programming Guide and Reference Version 5.2.0_BETA3 c⃝ 2004-2017 Oracle Corporation http://www.virtualbox.org Contents 1 Introduction 21 1.1 Modularity: the building blocks . . . . 39 2.3.6 C binding to VirtualBox API . . . . . . . . . . . . . . . . . . . . . . . . 39 3 Basic VirtualBox concepts; some examples 47 3.1 Obtaining basic machine information. Reading attributes . . . . 73 5.15.19 removeSharedFolder . . . . . . . . . . . . . . . . . . . . . . . . . . . . 73 3 Contents 5.15.20 reset . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 73

Pack Manager.......................................................................................84 3 Configuring Virtual Machines....................................................................... .............................................................. 124 4.6.1 Hardware 3D Acceleration (OpenGL and Direct3D 8/9)..........................................124 4.7 Seamless Windows.......... .............................................. 417 9.7.2 Configuring the Hard Disk Vendor Product Data (VPD)..........................................420 9.7.3 Access iSCSI Targets Using Internal Networking

. . . 2 1.3 Features Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3 1.4 Supported Host Operating Systems . . . . . . . . . . . . . . . . . . . . . . . . . 5 1.4.1 Host . . . . . . 49 2.4.6 Configuring a Zone for Running Oracle VM VirtualBox . . . . . . . . . . 50 3 Configuring Virtual Machines 51 3.1 Supported Guest Operating Systems . . . . . . . . . . . . . . 64 3.11 USB Support . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 66 3 Contents 3.11.1 USB Settings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 66

. . . . 41 2.3.6 C binding to VirtualBox API . . . . . . . . . . . . . . . . . . . . . . . . 42 3 Basic VirtualBox concepts; some examples 49 3.1 Obtaining basic machine information. Reading attributes . . 72 5.17.8 saveProfiles . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 72 3 Contents 5.18 ICloudProviderManager . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2 getVisibleRegion . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 113 5.43.3 notify3DEvent . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 114 5.43.4 notifyChange . .

. . . . . 43 2.4.6 Configuring a zone for running VirtualBox . . . . . . . . . . . . . . . . 43 3 Configuring virtual machines 44 3.1 Supported guest operating systems . . . . . . . . . . . . . . graphics . . . . . . . . . . . . . . . . . . . . . . . . . . . 74 4.5.1 Hardware 3D acceleration (OpenGL and Direct3D 8/9) . . . . . . . . . 74 4.5.2 Hardware 2D video acceleration for Windows guests . . . 79 4.9.2 Page Fusion . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 80 3 Contents 5 Virtual storage 82 5.1 Hard disk controllers: IDE, SATA (AHCI), SCSI, SAS, USB MSC .

. . . . . 43 2.4.6 Configuring a zone for running VirtualBox . . . . . . . . . . . . . . . . 43 3 Configuring virtual machines 44 3.1 Supported guest operating systems . . . . . . . . . . . . . . graphics . . . . . . . . . . . . . . . . . . . . . . . . . . . 74 4.5.1 Hardware 3D acceleration (OpenGL and Direct3D 8/9) . . . . . . . . . 74 4.5.2 Hardware 2D video acceleration for Windows guests storage 82 5.1 Hard disk controllers: IDE, SATA (AHCI), SCSI, SAS, USB MSC . . . . . . . . . . 82 3 Contents 5.2 Disk image files (VDI, VMDK, VHD, HDD) . . . . . . . . . . . . . . . . . . . . . 85

. . . . 41 2.3.6 C binding to VirtualBox API . . . . . . . . . . . . . . . . . . . . . . . . 41 3 Basic VirtualBox concepts; some examples 49 3.1 Obtaining basic machine information. Reading attributes . 71 5.18 ICloudProviderManager . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 72 3 Contents 5.18.1 Attributes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 72 2 getVisibleRegion . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 112 5.43.3 notify3DEvent . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 113 5.43.4 notifyChange . .

. . . 2 1.3 About web services in general . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3 1.4 Running the web service . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4 1.4.1 . . . . 19 2.3.6 C binding to VirtualBox API . . . . . . . . . . . . . . . . . . . . . . . . 20 3 Basic VirtualBox concepts; some examples 27 3.1 Obtaining basic machine information. Reading attributes 2 getVisibleRegion . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 111 5.64.3 notify3DEvent . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 111 5.64.4 notifyChange . .

. . . . 45 2.3.6 C binding to VirtualBox API . . . . . . . . . . . . . . . . . . . . . . . . 46 3 Basic VirtualBox concepts; some examples 53 3.1 Obtaining basic machine information. Reading attributes . . . . 75 5.20.3 createCloudMachine . . . . . . . . . . . . . . . . . . . . . . . . . . . . 75 3 Contents 5.20.4 createImage . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 75 2 getVisibleRegion . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 137 5.64.3 notify3DEvent . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 137 5.64.4 notifyChange . .

. . . . . . 45 2.4.6 Configuring a zone for running VirtualBox . . . . . . . . . . . . . . . . 45 3 Configuring virtual machines 47 3.1 Supported guest operating systems . . . . . . . . . . . . . . . graphics . . . . . . . . . . . . . . . . . . . . . . . . . . . 76 4.5.1 Hardware 3D acceleration (OpenGL and Direct3D 8/9) . . . . . . . . . 76 4.5.2 Hardware 2D video acceleration for Windows guests 78 4.8 Guest control . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 80 3 Contents 4.9 Memory overcommitment . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 80 4