Export (0) Print
Expand All

IVMVirtualMachine::AddDVDROMDrive method

Windows Virtual PC

[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
);

Parameters

busNumber [in]

The bus to which the drive will be attached.

ValueMeaning
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.

ValueMeaning
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.

Return value

This method can return one of these values.

Return code/valueDescription
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.

 

Remarks

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

Requirements

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

See also

IVMVirtualMachine

 

 

Community Additions

ADD
Show:
© 2014 Microsoft