IStreamBufferRecordControl::Start

  • Article
 
Microsoft DirectShow 9.0

IStreamBufferRecordControl::Start

This topic applies only to Windows XP Service Pack 1 or later.

The Start method starts the recording.

Syntax

  HRESULT Start(
  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 Values

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

Value 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: Include Sbe.h.

See Also