 Important: |
|---|
| This is retired content. This content is outdated and is no longer being maintained. It is provided as a courtesy for individuals who are still using these technologies. This content may contain URLs that were valid when originally published, but now link to sites or pages that no longer exist. |
Tells the pin when to start sending streaming data.
HRESULT StartAtconst REFERENCE_TIME * ptStart = NULL, DWORD dwCookie = 0 );
Parameters
- ptStart
- REFERENCE_TIMEat which to start streaming. If NULL, start immediately (no notification). If MAX_TIME, start canceled or will have no effect.
- dwCookie
- Specifies a particular value, other than 0, to be sent with the
notification when the start occurs. (Only used if ptStart is
non-NULL or MAX_TIME).
Return Values
Returns NOERROR.
Remarks
Streams are enabled by default, so this member function will have no effect unless you have previously called StopAt.
After the stream is in a STREAM_FLOWING state, the filter will send an EC_STREAM_CONTROL_STARTEDevent notification to the filter graph manager.
NoteIf start and stop are scheduled for a single point in time, the effect is as if the start occurred an infinitesimal time before the stop. You can use this effect to capture a single frame.