IDiscRecorder interface (imapi.h)
The IDiscRecorder interface enables access to a single disc recorder device, labeled the active disc recorder. An IMAPI object such as MSDiscMasterObj maintains an active disc recorder.
An IDiscRecorder object represents a single hardware device, but there can be multiple instances of IDiscRecorder all referencing the same hardware device. In this case, use OpenExclusive to access that device.
Inheritance
The IDiscRecorder interface inherits from the IUnknown interface. IDiscRecorder also has these types of members:
Methods
The IDiscRecorder interface has these methods.
| IDiscRecorder::Close Releases exclusive access to a disc recorder. This restores file system access to the drive. |
| IDiscRecorder::Eject Unlocks and ejects the tray of the disc recorder, if possible. |
| IDiscRecorder::Erase Attempts to erase the CD-RW media if this is a CD-RW disc recorder. Both full and quick erases are supported. |
| IDiscRecorder::GetBasePnPID Retrieves a base PnP string that can be used to consistently identify a specific class of device by make and model. The string can be used by applications to customize their behavior according to the specific recorder type. |
| IDiscRecorder::GetDisplayNames Retrieves a formatted name for the recorder that can be displayed. The name consists of the manufacturer and product identifier of the device. |
| IDiscRecorder::GetPath Retrieves a path to the device within the operating system. This path should be used in conjunction with the display name to completely identify an available disc recorder. |
| IDiscRecorder::GetRecorderGUID Retrieves the GUID of the physical disc recorder currently associated with the recorder object. |
| IDiscRecorder::GetRecorderProperties Retrieves a pointer to an IPropertyStorage interface. |
| IDiscRecorder::GetRecorderState Retrieves the disc recorder state. |
| IDiscRecorder::GetRecorderType Determines whether the disc recorder is a CD-R or CD-RW type device. This does not indicate the type of media that is currently inserted in the device. |
| IDiscRecorder::OpenExclusive Opens a disc recorder for exclusive access. |
| IDiscRecorder::QueryMediaInfo Retrieves information about the currently mounted media, such as the total number of blocks used on the media. |
| IDiscRecorder::QueryMediaType Detects the type of media currently inserted in the recorder, if any. |
| IDiscRecorder::SetRecorderProperties Accepts an IPropertyStorage pointer for an object with all the properties that the application wishes to change. Sparse settings are supported. |
Remarks
All IDiscRecorder interfaces may be used on an IDiscRecorder object even if the disc recorder is not the active disc recorder. The IMAPI client does not have to call IDiscMaster::SetActiveDiscRecorder first.
Requirements
| Requirement | Value |
|---|---|
| Minimum supported client | Windows XP [desktop apps only] |
| Minimum supported server | Windows Server 2003 [desktop apps only] |
| Target Platform | Windows |
| Header | imapi.h |