CBaseReferenceClock::AdviseTime (Windows CE 5.0)
Sets up a one-shot notification with the clock.
HRESULT AdviseTime(REFERENCE_TIMEbaseTime,REFERENCE_TIMEstreamTime,HEVENThEvent,DWORD* pdwAdviseToken);
Parameters
- baseTime
Base reference time. - streamTime
Stream offset time. - hEvent
Advise through this event. - pdwAdviseToken
Where the advise token goes.
Return Values
Returns one of the following HRESULT values.
| E_OUTOFMEMORY | Out of memory. |
| E_INVALIDARG | Invalid argument. |
| NOERROR | No error. |
Remarks
This member function implements the IReferenceClock::AdviseTime method.
At the time specified in the baseTime plus the streamTime parameters, the event specified in hEvent is set.
It is correct to call CBaseReferenceClock::Unadvise to remove the link after the event occurs, but it is not necessary. One-shot notifications are cleared by the clock when they have signaled.
To cancel a one-shot notification before the time is reached, call Unadvise and pass the pdwAdviseToken value returned from this call.
Requirements
DirectShow applications and DirectShow filters have different include file and link library requirements.
For more information, see Setting Up the Build Environment.
OS Versions: Windows CE 2.12 and later. Version 2.12 requires DXPAK 1.0 or later.
Header:
Send Feedback on this topic to the authors