CAMSchedule::Advise

  • Article
 
Microsoft DirectShow 9.0

CAMSchedule::Advise

The Advise method dispatches all requests that are scheduled for a specified time or earlier.

Syntax

  REFERENCE_TIME Advise(
    const REFERENCE_TIME& rtTime
);

Parameters

rtTime

Value that specifies the current reference time.

Return Value

Returns the reference time of the next scheduled advise request, or MAX_TIME if there are none left.

Remarks

When the clock calls this method, it specifies the current reference time. The scheduler determines which advise requests have expired, if any, and dispatches them. If a one-shot request expires, the scheduler deletes it. If a periodic request expires, the scheduler re-schedules it for the next advise time. The method returns the time of the next pending request.

To dispatch an advise request, the scheduler signals the event or semaphore given in the hNotify parameter of the CAMSchedule::AddAdvisePacket method.

Requirements

**  Header:** Declared in Dsschedule.h; include Streams.h.

**  Library:** Use Strmbase.lib (retail builds) or Strmbasd.lib (debug builds).

See Also