QueryIdleProcessorCycleTimeEx 函数 (realtimeapiset.h)

检索指定处理器组中每个逻辑处理器上空闲线程的累积周期时间。

语法

BOOL QueryIdleProcessorCycleTimeEx(
  [in]      USHORT   Group,
  [in, out] PULONG   BufferLength,
  [out]     PULONG64 ProcessorIdleCycleTime
);

参数

[in] Group

要为其检索周期时间的处理器组的数目。

[in, out] BufferLength

在输入时,指定 ProcessorIdleCycleTime 缓冲区的大小(以字节为单位)。 此缓冲区应是组中处理器数的 8 倍。

在输出中,指定写入缓冲区的元素数。 如果缓冲区大小不足,该函数将失败,并且此参数接收所需的缓冲区长度。

[out] ProcessorIdleCycleTime

每个空闲线程使用的 CPU 时钟周期数。 如果此参数为 NULL,则该函数会用所需的长度更新 BufferLength 参数。

返回值

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

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

言论

若要编译使用此函数的应用程序,请设置_WIN32_WINNT >= 0x0601。 有关详细信息,请参阅 使用 Windows 标头

要求

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

另请参阅

处理器组

QueryIdleProcessorCycleTime