IDiscMaster::SetActiveDiscRecorder method (imapi.h)
Selects an active disc recorder. The active disc recorder is the recorder where a burn will occur when RecordDisc is called.
Syntax
HRESULT SetActiveDiscRecorder(
[in] IDiscRecorder *pRecorder
);
Parameters
[in] pRecorder
Pointer to the IDiscRecorder interface of a disc recorder object. This pointer should have been returned by a previous call to EnumDiscRecorders.
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
SetActiveDiscRecorder must be called after the media to be used has been inserted, and before calling IJolietDiscMaster::AddData.
Selecting a recorder while in an active Joliet format will cause IMAPI to read information from the currently installed recorder disc. If this disc is a previous IMAPI Joliet disc and has space for another session, IMAPI automatically sets itself to multi-session mode. This disc must be in the active recorder when RecordDisc is called.
The MaxWriteSpeed property is updated when this method is called. The default setting is the highest write speed.
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 |