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