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
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 |
|
| IID |
IID_IVMDVDDrive is defined as b96328f6-6732-437d-a00d-ffa47e43971c |