Share via


CAMSchedule::Advise (Compact 2013)

3/26/2014

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

Header

dshow.h,
Streams.h

Library

ole32.lib,
Ole32auth.lib,
Strmbase.lib,
Strmiids.lib,
uuid.lib

See Also

Reference

CAMSchedule Class