IDVDDrive Interface Reference

The IDVDDrive interface represents the virtual CD/DVD drive of the virtual machine. More...

List of all members.

Public Member Functions
void	mountImage (in uuid imageId)
	Mounts the specified image.
void	captureHostDrive (in IHostDVDDrive drive)
	Captures the specified host drive.
void	unmount ()
	Unmounts the currently mounted image/device.
void	getImage ([retval] out IDVDImage image)
	Gets the currently mounted image ID.
void	getHostDrive ([retval] out IHostDVDDrive drive)
	Gets the currently mounted image ID.
Public Attributes
readonly attribute DriveState	state
	Current drive state.
attribute boolean	passthrough
	When a host drive is mounted and passthrough is enabled the guest will be able to directly send SCSI commands to the host drive.

---

Detailed Description

The IDVDDrive interface represents the virtual CD/DVD drive of the virtual machine.

Used in IMachine::DVDDrive.

Interface ID:

{D9BD101A-8079-4FB9-BAD1-31BF32482B75}

---

Member Function Documentation

void IDVDDrive::mountImage

(

in uuid

imageId

)

Mounts the specified image.

void IDVDDrive::captureHostDrive

(

in IHostDVDDrive

drive

)

Captures the specified host drive.

void IDVDDrive::unmount

(

)

Unmounts the currently mounted image/device.

void IDVDDrive::getImage

(

[retval] out IDVDImage

image

)

Gets the currently mounted image ID.

void IDVDDrive::getHostDrive

(

[retval] out IHostDVDDrive

drive

)

Gets the currently mounted image ID.

---

Member Data Documentation

readonly attribute DriveState IDVDDrive::state

Current drive state.

attribute boolean IDVDDrive::passthrough

When a host drive is mounted and passthrough is enabled the guest will be able to directly send SCSI commands to the host drive.

This enables the guest to use CD/DVD writers but is potentially dangerous.