Edit

Share via

IDiscFormat2TrackAtOnce::put_Recorder method (imapi2.h)

  • Article

Sets the recording device to use for the write operation.

Syntax

HRESULT put_Recorder(
  [in] IDiscRecorder2 *value
);

Parameters

[in] value

An IDiscRecorder2 interface that identifies the recording device to use in the write operation.

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:

Return code Description
E_IMAPI_DF2TAO_WRITE_IN_PROGRESS
 A write operation is in progress.

Value: 0xC0AA0500
E_IMAPI_DF2TAO_MEDIA_IS_PREPARED
 The requested operation is not valid when media has been "prepared" but not released.

Value: 0xC0AA0503
E_IMAPI_DF2TAO_RECORDER_NOT_SUPPORTED
 This device does not support the operations required by this disc format.

Value: 0xC0AA050E

Remarks

The recorder must be compatible with the format defined by this interface. To determine compatibility, call the IDiscFormat2::IsRecorderSupported method.

Requirements

Requirement Value
Minimum supported client Windows Vista, Windows XP with SP2 [desktop apps only]
Minimum supported server Windows Server 2003 [desktop apps only]
Target Platform Windows
Header imapi2.h

See also

IDiscFormat2TrackAtOnce

IDiscFormat2TrackAtOnce::get_Recorder