IVMDVDDrive interface

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

When to use

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 DVD 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
An enumerated value representing the type of media attached to the DVD drive within the virtual machine.
BusNumber
Read-only
The bus number to which this DVD drive is attached. For example, on an IDE bus, this value would represent either the primary or secondary location.
BusType
Read-only
The bus type (that is, IDE or SCSI) to which this DVD drive is attached.
DeviceNumber
Read-only
The device number to which this DVD drive is attached.
HostDriveLetter
Read-only
The letter of the host drive captured by this DVD drive.
ImageFile
Read-only
The full path of the image file captured by this DVD drive.

Requirements

Product
Microsoft Virtual Server 2005 onWindows Server 2003
Download
Microsoft Virtual Server 2005 R2 SP1 Update onWindows Server 2008orWindows Server 2003
Header
VsComInterfaces.h

See also

IDispatch