IDiscRecorder interface

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.

When to use

Use an instance of this object to select the recorder for a burn through IDiscMaster and to perform basic control tasks on a specific physical disc recorder.

Note  An application does not call CoCreateInstance for one of these objects, but instead uses the IDiscMaster::EnumDiscRecorders method to retrieve an enumerator that returns pointers to all the recorders valid for a specific format.
 

Members

The IDiscRecorder interface inherits from the IUnknown interface. IDiscRecorder also has these types of members:

Methods

The IDiscRecorder interface has these methods.

MethodDescription
Close

Closes a recorder after exclusive access.

Eject

Ejects a recorder's tray, if possible.

Erase

Erases CD-RW media, if possible.

GetBasePnPID

Retrieves identifier unique to device class.

GetDisplayNames

Retrieves a name suitable for GUI display.

GetPath

Retrieves a path to the device.

GetRecorderGUID

Retrieves the underlying device GUID.

GetRecorderProperties

Retrieves a pointer to the IPropertyStorage interface for the recorder.

GetRecorderState

Checks if recorder is ready to burn.

GetRecorderType

Identifies a device as CD-R or CD-RW.

Init

Initializes the object for an underlying device.

Used internally only.

OpenExclusive

Opens a device for exclusive use.

QueryMediaInfo

Retrieves media properties.

QueryMediaType

Identifies the type of media in the recorder.

SetRecorderProperties

Sets properties for the recorder.

 

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

Minimum supported client

Windows XP [desktop apps only]

Minimum supported server

Windows Server 2003 [desktop apps only]

Header

Imapi.h

Library

Uuid.lib

DLL

Actxprxy.dll

IID

IID_IDiscRecorder is defined as 85AC9776-CA88-4cf2-894E-09598C078A41

 

 

Community Additions

ADD
Show: