Поделиться через


Функция 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