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


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

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

Синтаксис

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

См. также

Получение высокоточных меток времени

Основные понятия

GetSystemTimePreciseAsFileTime

KeQueryPerformanceCounter

QueryPerformanceCounter

Справочные материалы

Время

Таймеры