IVMVirtualMachine::AddDVDROMDrive method

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

Adds a new CD or DVD drive to the virtual machine.

Syntax

HRESULT AddDVDROMDrive(
  [in]          long        busNumber,
  [in]          long        deviceNumber,
  [out, retval] IVMDVDDrive **dvdDrive
);

busNumber [in]

The bus to which the drive will be attached.

Value	Meaning
0	The drive will be attached to the first bus.
1	The drive will be attached to the second bus.

deviceNumber [in]

The device to which the drive will be attached.

Value	Meaning
0	The drive will be attached to the first device on the bus.
1	The drive will be attached to the second device on the bus.

dvdDrive [out, retval]

An IVMDVDDrive object.

This method can return one of these values.

Return code/value	Description
S_OK 0	The operation was successful.
E_POINTER 0x80004003	The dvdDrive parameter is NULL.
E_INVALIDARG 0x80000003	A parameter is not valid.
VM_E_VM_UNKNOWN 0xA0040207	The configuration is unknown.
VM_E_VM_RUNNING_OR_SAVED 0xA004020B	The virtual machine is in a running or saved state.
VM_E_DRIVE_BUS_LOC_IN_USE 0xA00400503	The specified bus location is in use.
VM_E_DRIVE_INVALID 0xA0040502	The drive specified is not valid.
DISP_E_EXCEPTION 0x80020009	An unexpected error has occurred.

You can only add a new CD or DVD drive to a stopped virtual machine.

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_IVMVirtualMachine is defined as f7092aa1-33ed-4f78-a59f-c00adfc2edd7