IWriteEngine2::put_StartingSectorsPerSecond method (imapi2.h)

Sets the estimated number of sectors per second that the recording device can write to the media at the start of the writing process.

Syntax

HRESULT put_StartingSectorsPerSecond(
  [in] LONG value
);

Parameters

[in] value

Approximate number of sectors per second that the recording device can write to the media at the start of the writing process. The default is -1 for maximum speed.

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

This is used to optimize sleep time in the write engine.

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_BytesPerSector

IWriteEngine2::put_EndingSectorsPerSecond