RtQueryPerformanceCounter

RtQueryPerformanceCounter retrieves the current value of the high-resolution performance counter (based on the processor’s time-stamp counter, TSC).

Syntax

BOOL RtQueryPerformanceCounter(
    LARGE_INTEGER* lpPerformanceCount
);

Parameters

lpPerformanceCount

Pointer to a variable that receives the current performance-counter value, in counts.

Return Value

If the function succeeds, it returns a non-zero value. If the function fails, it returns 0 (zero). To get extended error information, call GetLastError.

Remarks

On a multiprocessor computer, use RtQueryPerformanceCounter rather than RtGetClockTime. Using RtGetClockTime on more than one processor retrieves times that are not accurately aligned with each other, even when the functions are executed simultaneously.

To specify processor affinity for a thread, use the SetThreadAffinityMask function.

In a process, QueryPerformanceFrequency is the same as RtQueryPerformanceFrequency. QueryPerformanceCounter is the same as RtQueryPerformanceCounter.

See Also:

• RtQueryPerformanceFrequency