GetProcessorSystemCycleTime 函数 (sysinfoapi.h)
检索指定处理器组中每个处理器执行延迟过程调用所用的周期时间, (DPC) 和中断服务例程 (ISR) 自处理器变为活动状态以来。
语法
BOOL GetProcessorSystemCycleTime(
[in] USHORT Group,
[out] PSYSTEM_PROCESSOR_CYCLE_TIME_INFORMATION Buffer,
[in, out] PDWORD ReturnedLength
);
参数
[in] Group
要为其检索周期时间的处理器组的数目。
[out] Buffer
指向缓冲区的指针,用于接收组中每个处理器的SYSTEM_PROCESSOR_CYCLE_TIME_INFORMATION结构。 输出时,此结构的 DWORD64 CycleTime 成员设置为一个处理器的周期时间。
[in, out] ReturnedLength
缓冲区的大小(以字节为单位)。 当函数返回时,此参数包含写入 Buffer 的字节数。 如果缓冲区对于数据来说太小,则函数将失败并ERROR_INSUFFICIENT_BUFFER并将 ReturnedLength 参数设置为所需的缓冲区大小。
返回值
如果函数成功,则返回值为非零值。
如果函数失败,则返回值为零。 若要获取扩展的错误信息,请使用 GetLastError。
如果错误值为 ERROR_INSUFFICIENT_BUFFER,则 ReturnedLength 参数包含所需的缓冲区大小。
注解
若要编译使用此函数的应用程序,请将_WIN32_WINNT定义为 0x0601 或更高版本。 有关详细信息,请参阅 使用 Windows 标头。
要求
要求 | 值 |
---|---|
最低受支持的客户端 | Windows 7 [仅限桌面应用] |
最低受支持的服务器 | Windows Server 2008 R2 [仅限桌面应用] |
目标平台 | Windows |
标头 | sysinfoapi.h (包括 Windows.h) |
Library | Kernel32.lib |
DLL | Kernel32.dll |