Returns the remaining relative time until the specified timer's next expiration.

BOOLEAN RtGetTimer(
    HANDLE hTimer,
    PLARGE_INTEGER pTimeRemaining
);

Parameters

hTimer

Handle of the timer object.

pTimeRemaining

Pointer to a LARGE_INTEGER that receives the number of 100ns units that remain until expiration.

Although time is in 100ns units, the implementation uses the INtime system timer period (default 500us).

Return Values

TRUE

Success.

FALSE

Failure.

Requirements

Note

This function operates in the real-time portion of your application.

See Also

RtCreateTimer, RtSetTimer, RtSetTimerRelative, iwin32 API, iwin32 Overview