IDiscRecorder2Ex 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 ejecting the media. This interface retrieves information not available through IDiscRecorder2 interface, and provides easier access to some of the same property values in IDiscRecorder2.
To get an instance of this interface, create an instance of the IDiscRecorder2 interface and then call the IDiscRecorder2::QueryInterface method to retrieve the IDiscRecorder2Ex interface.
Note that you cannot access this functionality from script.
Inheritance
The IDiscRecorder2Ex interface inherits from the IDispatch interface. IDiscRecorder2Ex also has these types of members:
Methods
The IDiscRecorder2Ex interface has these methods.
| IDiscRecorder2Ex::GetAdapterDescriptor Retrieves the adapter descriptor for the device. |
| IDiscRecorder2Ex::GetByteAlignmentMask Retrieves the byte alignment mask for the device. |
| IDiscRecorder2Ex::GetDeviceDescriptor Retrieves the device descriptor for the device. |
| IDiscRecorder2Ex::GetDiscInformation Retrieves the disc information from the media. |
| IDiscRecorder2Ex::GetFeaturePage Retrieves the specified feature page from the device. |
| IDiscRecorder2Ex::GetMaximumNonPageAlignedTransferSize Retrieves the maximum non-page-aligned transfer size for the device. |
| IDiscRecorder2Ex::GetMaximumPageAlignedTransferSize Retrieves the maximum page-aligned transfer size for the device. |
| IDiscRecorder2Ex::GetModePage Retrieves the specified mode page from the device. |
| IDiscRecorder2Ex::GetSupportedFeaturePages Retrieves the list of supported feature pages or the current feature pages of the device. |
| IDiscRecorder2Ex::GetSupportedModePages Retrieves the supported mode pages for the device. |
| IDiscRecorder2Ex::GetSupportedProfiles Retrieves the supported profiles or the current profiles of the device. |
| IDiscRecorder2Ex::GetTrackInformation Retrieves the track information from the media. |
| IDiscRecorder2Ex::ReadDvdStructure Reads a DVD structure from the media. |
| IDiscRecorder2Ex::SendCommandGetDataFromDevice Sends a MMC command to the recording device requesting data from the device. |
| IDiscRecorder2Ex::SendCommandNoData Sends a MMC command to the recording device. Use this function when no data buffer is sent to nor received from the device. |
| IDiscRecorder2Ex::SendCommandSendDataToDevice Sends a MMC command and its associated data buffer to the recording device. |
| IDiscRecorder2Ex::SendDvdStructure Sends a DVD structure to the media. |
| IDiscRecorder2Ex::SetModePage Sets the mode page data for the device. |
Remarks
To write data to media, you need to attach this recorder to the IWriteEngine2 data writer, using the IWriteEngine2::put_Recorder method.
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 |