CBaseReferenceClock::AdviseTime (Windows Embedded CE 6.0)
1/6/2010
Sets up a one-shot notification with the clock.
Syntax
HRESULT AdviseTime(
REFERENCE_TIME baseTime,
REFERENCE_TIME streamTime,
HEVENT hEvent,
DWORD* pdwAdviseToken
);
Parameters
- baseTime
Base reference time.
- streamTime
Stream offset time.
- hEvent
Advise through this event.
- pdwAdviseToken
Where the advise token goes.
Return Value
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
| Windows Embedded CE | Windows CE 2.12 and later |
| Note | Microsoft DirectShow applications and DirectShow filters have different include file and Library requirements For more information, see Setting Up the Build Environment, Version 2.12 requires DXPAK 1.0 or later |