Microsoft DirectX 8.1 (C++)

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.

See Also