IStreamBufferRecordControl::Start method (sbe.h)

[The feature associated with this page, Microsoft TV Technologies, is a legacy feature. Microsoft strongly recommends that new code does not use this feature.]

The Start method starts the recording.

Syntax

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

Parameters

[in, out] prtStart

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.

Remarks

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

Requirements

See also

IStreamBufferRecordControl Interface

IStreamBufferRecordControl::Stop