Share via


IStreamBufferRecordControl::Start Method

This topic applies only to Windows XP Service Pack 1 or later.
The Start method starts the recording.

Syntax

HRESULT Start(
  [in, out]  REFERENCE_TIME *prtStart
);

Parameters

  • prtStart [in, out]
    Pointer to a variable that contains the start time. The time is relative to the current stream time, in 100-nanosecond units. The value zero represents now; negative values are in the past; and positive values are in the future.

    For content recordings, the time must be a value between 0 and 5 seconds (50000000), inclusive. Negative times are not valid.

    For reference recordings, negative times are valid if they fall within existing content. If the time given in prtStart is earlier than the earliest valid content, the actual start time of the content is used instead. This value is returned in prtStart when the method returns.

Return Value

Returns an HRESULT. Possible values include those in the following table.

Return code Description

E_INVALIDARG

Invalid time.

E_POINTER

NULL pointer argument.

S_OK

The method succeeded.

Remarks

The start time must be less than or equal to the stop time.

Requirements

Header Declared in Sbe.h.

See Also

IStreamBufferRecordControl Interface
IStreamBufferRecordControl::Stop

Send comments about this topic to Microsoft

Build date: 12/4/2008