IDiscFormat2RawCD::put_RequestedSectorType method (imapi2.h)

Article
10/13/2021

Sets the requested data sector to use for writing the stream.

Syntax

HRESULT put_RequestedSectorType(
  [in] IMAPI_FORMAT2_RAW_CD_DATA_SECTOR_TYPE value
);

Parameters

[in] value

Data sector to use for writing the stream. For possible values, see the IMAPI_FORMAT2_RAW_CD_DATA_SECTOR_TYPE enumeration type. The default is IMAPI_FORMAT2_RAW_CD_SUBCODE_IS_COOKED.

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_DF2RAW_WRITE_IN_PROGRESS	There is currently a write operation in progress. Value: 0xC0AA0600
E_IMAPI_DF2RAW_MEDIA_IS_NOT_PREPARED	The requested operation is only valid when media has been "prepared". Value: 0xC0AA0602
E_IMAPI_DF2RAW_DATA_BLOCK_TYPE_NOT_SUPPORTED	The requested data block type is not supported by the current device. Value: 0xC0AA060E

Remarks

For a list of supported data sector types, call the IDiscFormat2RawCD::get_SupportedSectorTypes 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