IWriteEngine2::put_BytesPerSector method (imapi2.h)

Sets the number of bytes to use for each sector during writing.

Syntax

HRESULT put_BytesPerSector(
  [in] LONG value
);

Parameters

[in] value

Number of bytes to use for each sector during writing. The minimum size is 1 byte and the maximum is MAXLONG bytes. Typically, this value is 2,048 bytes for CD media, although any arbitrary size is supported (such as 2352 or 2448). This value is limited to the IDiscRecorder2Ex::GetMaximumPageAlignedTransferSize, which is typically 65,536 (64K) bytes.

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_FAIL
Unspecified failure.

Value: 0x80004005

E_INVALIDARG
One or more arguments are not valid.

Value: 0x80070057

Remarks

You must specify a logical block size.

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

IWriteEngine2

IWriteEngine2::get_BytesPerSector

IWriteEngine2::get_EndingSectorsPerSecond

IWriteEngine2::get_StartingSectorsPerSecond

IWriteEngine2::put_EndingSectorsPerSecond

IWriteEngine2::put_StartingSectorsPerSecond