This topic has not yet been rated - Rate this topic

IDiscRecorder2 interface

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.

Members

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

Methods

Methods

The IDiscRecorder2 interface has these methods.

Method	Description
AcquireExclusiveAccess	Acquires exclusive access to the device.
CloseTray	Closes the media tray.
DisableMcn	Disables Media Change Notification for the device.
EjectMedia	Ejects media from the device.
EnableMcn	Enables Media Change Notification for the device.
get_ActiveDiscRecorder	Retrieves the unique identifier used to initialize the disc device.
get_CurrentFeaturePages	Retrieves the list of features of the device that are marked as current.
get_CurrentProfiles	Retrieves all MMC profiles of the device that are marked as current.
get_DeviceCanLoadMedia	Determines if the device can eject and subsequently reload media.
get_ExclusiveAccessOwner	Retrieves the name of the user that has exclusive access to the device.
get_LegacyDeviceNumber	Retrieves the legacy device number for a CD or DVD device.
get_ProductId	Retrieves the product ID of the device.
get_ProductRevision	Retrieves the product revision code of the device.
get_SupportedFeaturePages	Retrieves the list of features that the device supports.
get_SupportedModePages	Retrieves the list of MMC mode pages that the device supports.
get_SupportedProfiles	Retrieves the list of MMC profiles that the device supports.
get_VendorId	Retrieves the vendor ID of the device.
get_VolumeName	Retrieves the unique volume name associated with the device.
get_VolumePathNames	Retrieves the drive letters and NTFS mount points for the device.
InitializeDiscRecorder	Associates the object with the specified disc device.
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

Minimum supported client	Windows Vista, Windows XP with SP2 [desktop apps only]
Minimum supported server	Windows Server 2003 [desktop apps only]
IDL	Imapi2.idl

Community Additions