 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. |
Informs the pin when to start sending streaming data.
HRESULT StartAt( const REFERENCE_TIME * ptStart , DWORD dwCookie );
Parameters
- ptStart
- [in] Time at which to start streaming as specified in the REFERENCE_TIMEstructure. If NULL, start immediately (no notification); if MAX_TIME, start canceled and will have no effect.
- dwCookie
- [in] Specifies a particular value to be sent with the
notification when the start occurs. (Only used if
ptStartis non-NULL or MAX_TIME).
Return Values
Returns an HRESULTvalue that depends on the implementation of the interface.
Remarks
Streams are enabled by default, so this method will have no effect unless a previous StopAtmember function has been called.
If the pointer to the REFERENCE_TIMEis not NULL or MAX_TIME, then pins should signal EC_STREAM_CONTROL_STARTEDwith an IPinpointer and the cookie specified in the dwCookieparameter. This enables applications to tie the events back to their requests. If the ptStartpointer is NULL or MAX_TIME, then the filter graph sends no event.
If 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 to capture a single frame.