IStreamBufferRecordControl::Start
| 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