IVMDVDDrive interface

[Windows Virtual PC is no longer available for use as of Windows 8. Instead, use the Hyper-V WMI provider (V2).]

Controls a CD-ROM or DVD-ROM drive within a virtual machine. IVMDVDDrive can notify clients about events using the IVMDVDDriveEvents outgoing interface.

You can add a new CD-ROM or DVD-ROM drive to a virtual machine using the IVMVirtualMachine::AddDVDROMDrive method. You can remove an existing CD-ROM or DVD-ROM drive from a virtual machine using the IVMVirtualMachine::RemoveDVDROMDrive method. You can retrieve an IVMDVDDrive object from the IVMDVDDriveCollection object returned from the IVMVirtualMachine::DVDROMDrives property.

Members

The IVMDVDDrive interface inherits from the IDispatch interface. IVMDVDDrive also has these types of members:

• Methods
• Properties

Methods

The IVMDVDDrive interface has these methods.

Method	Description
AttachHostDrive	Attaches a host drive to the DVD drive within the virtual machine.
AttachImage	Attaches an ISO image to the DVD drive within the virtual machine.
ReleaseHostDrive	Releases a captured host drive from the DVD drive.
ReleaseImage	Releases a captured ISO image from the DVD drive.
SetBusLocation	Attaches the DVD drive to the specified bus location in the virtual machine.

Properties

The IVMDVDDrive interface has these properties.

Property	Access type	Description
Attachment	Read-only	The type of media attached to the DVD drive within the virtual machine.
BusNumber	Read-only	The bus number to which this device is attached.
DeviceNumber	Read-only	The device number to which this drive is attached.
HostDriveLetter	Read-only	The letter of the host drive set for this device.
ImageFile	Read-only	The full path of the image file set for this device.

Requirements

Requirement	Value
Minimum supported client	Windows 7 [desktop apps only]
Minimum supported server	None supported
End of client support	Windows 7
Product	Windows Virtual PC
Header	VPCCOMInterfaces.h
IID	IID_IVMDVDDrive is defined as b96328f6-6732-437d-a00d-ffa47e43971c