RtGetTimer

RtGetTimer returns the remaining relative time until the next expiration of the specified timer.

Syntax

BOOL RtGetTimer(
    HANDLE hTimer,
    PLARGE_INTEGER pTimeRemaining
);

Parameters

hTimer

An RTX-specific handle to the timer.

pTimeRemaining

A pointer to a LARGE_INTEGER structure in which to store the remaining time until expiration.

Return Value

TRUE if the function succeeds, FALSE if invalid parameters are specified

Remarks

RtGetTimer returns the relative amount of time until the specified timer expires. The time is specified in 100ns units and is written into the user-provided LARGE_INTEGER structure.

NOTE: If your timer period is close to Real-time subsystem’s HAL timer period, the overhead of Subsystem tick processing may cause a much larger response latency of your timer handling routine (IST). In this case, you should configure a much smaller HAL timer period. For example, if your timer period is 100 us, you should configure HAL period to a smaller value, such as 20 us, depending on your processor frequency. See the Control Panel for how to modify the Hal timer period.

Requirements

Minimum Supported Version	RTX64 2013
Header	Rtapi.h
Library	RtApi.lib (Windows), Rtx_Rtss.lib (RTSS)