RtQueryPerformanceFrequency

RtQueryPerformanceFrequency retrieves the frequency of the high-resolution performance counter (based on the processor’s time-stamp counter, TSC). The frequency cannot change while the system is running.

Syntax

BOOL RtQueryPerformanceFrequency(
    LARGE_INTEGER* lpFrequency);

Parameters

lpFrequency

Pointer to a variable that receives the performance-counter frequency, in counts per second.

Return Value

A non-zero value if the function succeeds, 0 (zero) if the function fails. To get extended error information, call GetLastError.

Remarks

In a Win32 process, RtQueryPerformanceFrequency call may return different frequency than the QueryPerformanceFrequency call. This is because QueryPerformanceFrequency may be based on HPET. For consistency, use the frequency returned by RtQueryPerformanceFrequency when converting the counters returned from RtQueryPerformanceCounter to time. Use the frequency returned by QueryPerformanceFrequency when converting the counters returned from QueryPerformanceCounter to time.

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

See Also:

RtQueryPerformanceCounter