QueryThreadCycleTime 函数 (realtimeapiset.h)

检索指定线程的周期时间。

语法

BOOL QueryThreadCycleTime(
  [in]  HANDLE   ThreadHandle,
  [out] PULONG64 CycleTime
);

参数

[in] ThreadHandle

线程的句柄。 句柄必须具有PROCESS_QUERY_INFORMATION或PROCESS_QUERY_LIMITED_INFORMATION访问权限。 有关详细信息,请参阅 进程安全性和访问权限

[out] CycleTime

线程使用的 CPU 时钟周期数。 此值包括用户模式和内核模式所用的周期。

返回值

如果函数成功,则返回值为非零。

如果函数失败,则返回值为零。 若要获取扩展的错误信息,请调用 GetLastError

言论

若要枚举进程的线程,请使用 Thread32FirstThread32Next 函数。 若要获取线程标识符的线程句柄,请使用 OpenThread 函数。

不要尝试将 QueryThreadCycle Time 返回的 CPU 时钟周期转换为已用时间。 此函数使用 CPU 提供的计时器服务,这在实现中可能会有所不同。 例如,某些 CPU 在更改 CPU 运行频率时,某些 CPU 会改变计时器的频率,而其他 CPU 将以固定速率保留计时器。 CPU 供应商提供的文档描述了每个 CPU 的行为。

若要编译使用此函数的应用程序,请将_WIN32_WINNT定义为0x0600或更高版本。

要求

要求 价值
最低支持的客户端 Windows Vista [仅限桌面应用]
支持的最低服务器 Windows Server 2008 [仅限桌面应用]
目标平台 窗户
标头 realtimeapiset.h (包括 Windows 7 上的 Windows.h、Windows Server 2008 Windows Server 2008 R2)
Mincore.lib
DLL Kernel32.dll

另请参阅

QueryIdleProcessorCycleTime

QueryProcessCycleTime