Функция 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
Справочные материалы