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

A handle to the timer.

pTimeRemaining

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

Return Value

If the function succeeds, it returns TRUE. If invalid parameters are specified, it returns FALSE.

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 eRTOS HAL timer period, the overhead of kernel 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 50 us, depending on your processor frequency.

See Also:

• RtCreateTimer
• RtDeleteTimer
• RtGetClockResolution
• RtGetClockTime
• RtGetClockTimerPeriod
• RtSetClockTime
• RtSetTimer
• RtSetTimerRelative