Функция QueryPerformanceFrequency (profileapi.h)

Статья
08/25/2023

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

Синтаксис

BOOL QueryPerformanceFrequency(
  [out] LARGE_INTEGER *lpFrequency
);

Параметры

[out] lpFrequency

Указатель на переменную, которая получает текущую частоту счетчика производительности в количестве счетчиков в секунду. Если установленное оборудование не поддерживает счетчик производительности с высоким разрешением, этот параметр может быть равен нулю (это не будет происходить в системах под управлением Windows XP или более поздней версии).

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

Если установленное оборудование поддерживает счетчик производительности с высоким разрешением, возвращается ненулевое значение.

Если функция выполняется неудачно, возвращается нулевое значение. Дополнительные сведения об ошибке можно получить, вызвав GetLastError. В системах под управлением Windows XP или более поздних версий функция всегда будет успешно выполняться и, таким образом, никогда не будет возвращать ноль.

Требования

Требование	Значение
Минимальная версия клиента	Windows 2000 Профессиональная [классические приложения \| Приложения UWP]
Минимальная версия сервера	Windows 2000 Server [классические приложения \| Приложения UWP]
Целевая платформа	Windows
Header	profileapi.h (включая Windows.h)
Библиотека	Kernel32.lib
DLL	Kernel32.dll