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

Статья
08/08/2023

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

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

Синтаксис

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

Параметры

[out, optional] PerformanceFrequency

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

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

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

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

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

Требования

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