CAMSchedule::Advise
A version of this page is also available for
4/8/2010
Requests the scheduler to dispatch all events up to and including the time specified.
This method is expected to be called by a controlling clock specifying the current time, just in time to dispatch the next advise request.
Syntax
REFERENCE_TIME Advise(
const REFERENCE_TIME & rtTime
);
Parameters
- rtTime
Current reference time.
Return Value
Returns the reference time at which the next advise will expire, or MAX_TIME if there are no outstanding events.
Remarks
Clocks can call this method to advise the scheduler of the time. The scheduler will then signal all the events that have expired, and reschedule the periodic ones.
It is not intended that clocks should call this method all of the time; rather, that clocks will call Advise just one time.
The time returned will be invalidated if you start adding extra advises.
Requirements
| Windows Embedded CE | Windows CE 2.12 and later |
| Windows Mobile | Windows Mobile Version 5.0 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 |