IDiscMaster::GetActiveDiscRecorder method (imapi.h)
Retrieves an interface pointer to the active disc recorder. The active disc recorder is the recorder where a burn will occur when RecordDisc is called.
Syntax
HRESULT GetActiveDiscRecorder(
[out] IDiscRecorder **ppRecorder
);
Parameters
[out] ppRecorder
Pointer to the IDiscRecorder interface of the currently selected disc recorder.
Return value
S_OK is returned on success, but other success codes may be returned as a result of implementation. The following error codes are commonly returned on operation failure, but do not represent the only possible error values:
Remarks
There is no default active disc recorder. An application using this method must specifically select both an active mastering format and an active disc recorder before initiating a burn.
Note
The active disc recorder can be invalidated by removing the device or changing the active disc mastering format. For example, a USB CD-R device may be disconnected from the machine while the application is still running (the application is alerted to this condition by a call to IDiscMasterProgressEvents::NotifyPnPActivity). In either case, you must select a new active disc recorder.
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 |
| Library | Uuid.lib |
| DLL | Actxprxy.dll |