Partager via


CAMSchedule::Advise (Windows Embedded CE 6.0)

1/6/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
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

See Also

Reference

CAMSchedule Class