getSystemCpuSetInformation 函数 (processthreadsapi.h)
允许应用程序查询系统上的可用 CPU 集及其当前状态。
语法
BOOL GetSystemCpuSetInformation(
PSYSTEM_CPU_SET_INFORMATION Information,
ULONG BufferLength,
PULONG ReturnedLength,
HANDLE Process,
ULONG Flags
);
参数
Information
指向接收 CPU 集数据的 SYSTEM_CPU_SET_INFORMATION 结构的指针。 传递 NULL,缓冲区长度为 0,以确定所需的缓冲区大小。
BufferLength
作为 Information 参数传递的输出缓冲区的长度(以字节为单位)。
ReturnedLength
如果缓冲区足够大,则为输出缓冲区中有效数据的长度(以字节为单位),或者输出缓冲区的所需大小。 如果不存在 CPU 集,此值将为 0。
Process
进程的可选句柄。 此过程用于确定 SYSTEM_CPU_SET_INFORMATION 结构中 AllocatedToTargetProcess 标志的值。 如果将 CPU 集分配给指定的进程,则设置 标志。 否则,这是明确的。 此句柄必须具有PROCESS_QUERY_LIMITED_INFORMATION访问权限。 还可以在此处指定 GetCurrentProcess 返回的值。
Flags
保留,必须为 0。
返回值
如果 API 成功,则返回 TRUE。 如果失败,可通过 GetLastError 获取错误原因。 如果信息缓冲区为 NULL 或不够大,则返回错误代码ERROR_INSUFFICIENT_BUFFER。 传递的有效参数和足以容纳所有返回数据的缓冲区时,此 API 不会失败。
要求
要求 | 值 |
---|---|
最低受支持的客户端 | Windows 10 |
最低受支持的服务器 | WIndows Server 2016 |
标头 | processthreadsapi.h |