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