Edit

IDiscMaster::SetActiveDiscRecorder method (imapi.h)

  • Article

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

See also

IDiscMaster