QueryIdleProcessorCycleTime 函数 (realtimeapiset.h)
检索系统中每个处理器的空闲线程的周期时间。
在处理器数超过 64 的系统上,此函数检索 处理器组中每个处理器的空闲线程的周期时间, 为其分配调用线程。 使用 QueryIdleProcessorCycleTimeEx 函数检索特定处理器组每个逻辑处理器上的空闲线程的周期时间。
语法
BOOL QueryIdleProcessorCycleTime(
[in, out] PULONG BufferLength,
[out] PULONG64 ProcessorIdleCycleTime
);
参数
[in, out] BufferLength
在输入时,指定 ProcessorIdleCycleTime 缓冲区的大小(以字节为单位)。 此缓冲区应是组中处理器数的 8 倍。
在输出中,指定写入缓冲区的元素数。 如果缓冲区大小不足,该函数将失败,并且此参数接收所需的缓冲区长度。
[out] ProcessorIdleCycleTime
每个空闲线程使用的 CPU 时钟周期数。 此缓冲区的大小必须为系统处理器数的 8 倍。
返回值
如果函数成功,则返回值为非零。
如果函数失败,则返回值为零。 若要获取扩展的错误信息,请调用 GetLastError。
言论
若要编译使用此函数的应用程序,请将_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 |