Public Member Functions | |
void | mountImage (in uuid imageId) |
Mounts a CD/DVD image with the specified UUID. | |
void | captureHostDrive (in IHostDVDDrive drive) |
Captures the specified host CD/DVD drive. | |
void | unmount () |
Unmounts the currently mounted image or host drive. | |
void | getImage ([retval] out IDVDImage image) |
Returns the currently mounted CD/DVD image. | |
void | getHostDrive ([retval] out IHostDVDDrive drive) |
Returns the currently mounted host CD/DVD drive. | |
Public Attributes | |
readonly attribute DriveState | state |
Current drive state. | |
attribute boolean | passthrough |
When a host drive is mounted and passthrough is enabled the guest OS will be able to directly send SCSI commands to the host drive. |
An object of this type is returned by IMachine::DVDDrive.
{D650EF30-BE9B-4DAE-B463-11D5824681A5}
void IDVDDrive::mountImage | ( | in uuid | imageId | ) |
Mounts a CD/DVD image with the specified UUID.
VBOX_E_FILE_ERROR | Invalid image file location. |
VBOX_E_OBJECT_NOT_FOUND | Could not find a CD/DVD image matching imageId. |
VBOX_E_INVALID_OBJECT_STATE | Invalid media state. |
void IDVDDrive::captureHostDrive | ( | in IHostDVDDrive | drive | ) |
Captures the specified host CD/DVD drive.
void IDVDDrive::unmount | ( | ) |
Unmounts the currently mounted image or host drive.
void IDVDDrive::getImage | ( | [retval] out IDVDImage | image | ) |
Returns the currently mounted CD/DVD image.
void IDVDDrive::getHostDrive | ( | [retval] out IHostDVDDrive | drive | ) |
Returns the currently mounted host CD/DVD drive.
readonly attribute DriveState IDVDDrive::state |
Current drive state.
attribute boolean IDVDDrive::passthrough |
When a host drive is mounted and passthrough is enabled the guest OS will be able to directly send SCSI commands to the host drive.
This enables the guest OS to use CD/DVD writers but is potentially dangerous.