RtGetClockTimerPeriod

RtGetClockTimerPeriod obtains the minimum timer period of the specified clock. The RtGetClockTime call delivers the clock time as 64-bit quantity of 100 ns.

Syntax

BOOL RtGetClockTimerPeriod(
    [in]    CLOCK Clock,
    [out]   PLARGE_INTEGER pTime
);

Parameters

[in] Clock

A clock identifier.

[out] pTime

A pointer to a LARGE_INTEGER structure in which to store the results.

Return Value

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

Remarks

RtGetClockTimerPeriod obtains the minimum timer period of the specified clock. Timers with an expiration interval smaller than this will produce unpredictable results. See the table in the RtCreateTimer Comments section for a list of legal clock values.

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 wRTOS Settings for how to modify the HAL Timer Period.

Requirements

See Also:

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