CAMSchedule::Advise (Windows CE 5.0)

Send Feedback

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.

REFERENCE_TIME Advise(const REFERENCE_TIME &rtTime);

Parameters

  • rtTime
    Current reference time.

Return Values

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

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

Feedback FAQs

© 2006 Microsoft Corporation. All rights reserved.