IDiscRecorder2 interface (imapi2.h)

This interface represents a physical device. You use this interface to retrieve information about a CD and DVD device installed on the computer and to perform operations such as closing the tray or eject the media.

To create an instance of this interface, call the CoCreateInstance function. Use__uuidof(MsftDiscRecorder2) for the class identifier and __uuidof(IDiscRecorder2) for the interface identifier.

Inheritance

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

Methods

The IDiscRecorder2 interface has these methods.

 
IDiscRecorder2::AcquireExclusiveAccess

Acquires exclusive access to the device.
IDiscRecorder2::CloseTray

Closes the media tray.
IDiscRecorder2::DisableMcn

Disables Media Change Notification (MCN) for the device.
IDiscRecorder2::EjectMedia

Ejects media from the device.
IDiscRecorder2::EnableMcn

Enables Media Change Notification (MCN) for the device.
IDiscRecorder2::get_ActiveDiscRecorder

Retrieves the unique identifier used to initialize the disc device.
IDiscRecorder2::get_CurrentFeaturePages

Retrieves the list of feature pages of the device that are marked as current.
IDiscRecorder2::get_CurrentProfiles

Retrieves all MMC profiles of the device that are marked as current.
IDiscRecorder2::get_DeviceCanLoadMedia

Determines if the device can eject and subsequently reload media.
IDiscRecorder2::get_ExclusiveAccessOwner

Retrieves the name of the client application that has exclusive access to the device.
IDiscRecorder2::get_LegacyDeviceNumber

Retrieves the legacy device number for a CD or DVD device.
IDiscRecorder2::get_ProductId

Retrieves the product ID of the device.
IDiscRecorder2::get_ProductRevision

Retrieves the product revision code of the device.
IDiscRecorder2::get_SupportedFeaturePages

Retrieves the list of features that the device supports.
IDiscRecorder2::get_SupportedModePages

Retrieves the list of MMC mode pages that the device supports.
IDiscRecorder2::get_SupportedProfiles

Retrieves the list of MMC profiles that the device supports.
IDiscRecorder2::get_VendorId

Retrieves the vendor ID for the device.
IDiscRecorder2::get_VolumeName

Retrieves the unique volume name associated with the device.
IDiscRecorder2::get_VolumePathNames

Retrieves a list of drive letters and NTFS mount points for the device.
IDiscRecorder2::InitializeDiscRecorder

Associates the object with the specified disc device.
IDiscRecorder2::ReleaseExclusiveAccess

Releases exclusive access to the device.

Remarks

To create the MsftDiscRecorder2 object in a script, use IMAPI2.MsftDiscRecorder2 as the program identifier when calling CreateObject.

To write data to media, you need to attach a recorder to a format writer, for example, to attach the recorder to a data writer, call the IDiscFormat2Data::put_Recorder method.

Several properties of this interface return packet data defined by Multimedia Command (MMC). For information on the format of the packet data, see the latest revision of the MMC specification at ftp://ftp.t10.org/t10/drafts/mmc5.

Requirements

Requirement Value
Minimum supported client Windows Vista, Windows XP with SP2 [desktop apps only]
Minimum supported server Windows Server 2003 [desktop apps only]
Target Platform Windows
Header imapi2.h

See also

IDiscRecorder2Ex