NtQueryPerformanceCounter function

[This function is not supported and should not be used. Use the QueryPerformanceCounter and QueryPerformanceFrequency functions instead.]

Returns the current value of a performance counter and, optionally, the frequency of the performance counter.

Syntax

NTSTATUS NtQueryPerformanceCounter(
  _Out_      PLARGE_INTEGER PerformanceCounter,
  _Out_opt_  PLARGE_INTEGER PerformanceFrequency
);

Parameters

PerformanceCounter [out]

The address of a variable to receive the current performance counter value.

PerformanceFrequency [out, optional]

The address of a variable to receive the performance counter frequency.

Return value

If the function succeeds, it returns the NTSTATUS code STATUS_SUCCESS; otherwise, it returns an error code such as STATUS_ACCESS_VIOLATION.

Remarks

No header file is available for NtQueryPerformanceCounter. You should use the alternative functions named above, although you can also use the LoadLibrary and GetProcAddress functions to dynamically link to Ntdll.dll.

Performance frequency is the frequency of the performance counter in hertz, specifically in counts per second. This value is implementation dependent. If the implementation does not have hardware to support performance timing, the value returned is 0.

Requirements

See also

QueryPerformanceCounter

QueryPerformanceFrequency

Send comments about this topic to Microsoft

Build date: 12/7/2012