| Microsoft DirectX 8.1 (C++) |
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