RtGetClockTime

RtGetClockTime obtains the current value of the specified clock.

Syntax

BOOL RtGetClockTime(
    CLOCK Clock,
    PLARGE_INTEGER pTime
);

Parameters

Clock

A clock identifier.

pTime

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

Return Values

TRUE if the function completes successfully, FALSE if invalid parameters are specified

Remarks

RtGetClockTime obtains the value of the specified clock. The time is specified in 100ns units. See the table in the RtCreateTimer Comments section for a list of legal clock values.

When RTX is configured to use more than one processor on a multiprocessor computer, it should not matter on which processor RtGetClockTime is called. However, you may get different results on different processors due to deviations that exist among local APIC timers. For this reason, if you want to trace the execution sequence of two events on different processors, Use QueryPerformanceCounter, instead of RtGetClockTime.

Requirements

Header Rtapi.h
Library rtapi_w32.lib (Windows), Rtx_Rtss.lib (RTSS)

See Also:

RtCancelTimer

RtCreateTimer

RtDeleteTimer

RtGetClockResolution

RtGetClockTimerPeriod

RtSetClockTime

RtSetTimer

RtSetTimerRelative

IntervalZero.com | Support | Give Feedback