Функция KeQueryPerformanceCounter (ntifs.h)

  • Статья

Подпрограмма KeQueryPerformanceCounter извлекает текущее значение и частоту счетчика производительности.

Используйте KeQueryPerformanceCounter для получения меток времени с высоким разрешением (<1 мкс) для измерения интервалов времени.

Синтаксис

NTHALAPI LARGE_INTEGER KeQueryPerformanceCounter(
  [out, optional] PLARGE_INTEGER PerformanceFrequency
);

Параметры

[out, optional] PerformanceFrequency

Указатель на переменную, на которую KeQueryPerformanceCounter записывает частоту счетчика производительности в тактах в секунду. Этот параметр является необязательным и может иметь значение NULL, если вызывающей системе не требуется значение счетчика частоты.

Возвращаемое значение

KeQueryPerformanceCounter возвращает значение счетчика производительности в единицах тактов.

Комментарии

KeQueryPerformanceCounter возвращает 64-разрядное целое число, представляющее текущее значение монотонно несоздаемого счетчика с высоким разрешением.

Чтобы получить частоту счетчика производительности, укажите значение указателя, отличного от NULL , для параметра PerformanceFrequency . Частота счетчика производительности фиксируется при загрузке системы и согласована на всех процессорах. Таким образом, драйвер может кэшировать частоту счетчика производительности во время инициализации.

Дополнительные сведения об этой функции и ее использовании см. в разделе Получение меток времени с высоким разрешением.

Требования

Требование Значение
Минимальная версия клиента Windows 2000
Целевая платформа Универсальное
Верхняя часть ntifs.h (включая Wdm.h, Ntddk.h, Ntifs.h)
Библиотека Hal.lib
DLL Hal.dll
IRQL Любой уровень

См. также раздел

KeQueryInterruptTime

KeQueryTickCount

KeQueryTimeIncrement

QueryPerformanceCounter

QueryPerformanceFrequency