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