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


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

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

Синтаксис

BOOL QueryPerformanceFrequency(
  [out] LARGE_INTEGER *lpFrequency
);

Параметры

[out] lpFrequency

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

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

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

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

Замечания

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

Требования

Требование Ценность
Минимальный поддерживаемый клиент Windows 2000 Профессиональный [классические приложения | Приложения UWP]
минимальный поддерживаемый сервер Windows 2000 Server [классические приложения | Приложения UWP]
целевая платформа Виндоус
Header profileapi.h (include Windows.h)
Library Kernel32.lib
DLL Kernel32.dll

См. также

Получение меток времени с высоким разрешением

Концептуальный

GetSystemTimePreciseAsFileTime

KeQueryPerformanceCounter

QueryPerformanceCounter

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

Время

Таймеры