QueryPerformanceFrequency 函数 (profileapi.h)

检索性能计数器的频率。 性能计数器的频率在系统启动时固定,在所有处理器中保持一致。 因此,只需在应用程序初始化时查询频率,并且可以缓存结果。

Syntax

BOOL QueryPerformanceFrequency(
  [out] LARGE_INTEGER *lpFrequency
);

参数

[out] lpFrequency

指向接收当前性能计数器频率的变量的指针,以每秒计数为单位。 如果已安装的硬件不支持高分辨率性能计数器,此参数可以为零(这不会发生在运行 Windows XP 或更高版本的系统上)。

返回值

如果已安装的硬件支持高分辨率性能计数器,则返回值为非零。

如果函数失败,则返回值为零。 若要获取扩展的错误信息,请调用 GetLastError。 在运行 Windows XP 或更高版本的系统上,当给定的有效参数时,函数将始终成功,因此永远不会返回零。

注解

有关此函数及其用法的详细信息,请参阅 获取高分辨率时间戳

要求

Requirement 价值
最低支持的客户端 Windows 2000 Professional [桌面应用 |UWP 应用]
支持的最低服务器 Windows 2000 Server [桌面应用 |UWP 应用]
目标平台 Windows操作系统
Header profileapi.h (包括 Windows.h)
Library Kernel32.lib
DLL Kernel32.dll

另请参阅

获取高分辨率时间戳

概念

GetSystemTimePreciseAsFileTime

KeQueryPerformanceCounter

QueryPerformanceCounter

引用

时间

定时器