GetSystemCpuSetInformation 函数

允许应用程序查询系统上的可用 CPU 集及其当前状态。

语法

BOOL WINAPI GetSystemCpuSetInformation(
  _Out_opt_  PSYSTEM_CPU_SET_INFORMATION  Information,
  _In_       ULONG                        BufferLength,
  _Out_      PULONG                       ReturnedLength,
  _In_opt_   HANDLE                       Process,
  _Reserved_ ULONG                        Flags
);

parameters

Information [out， optional]

指向接收 CPU 集数据的 SYSTEM_CPU_SET_INFORMATION 结构的指针。 传递 NULL，缓冲区长度为 0，以确定所需的缓冲区大小。

BufferLength [in]

作为 Information 参数传递的输出缓冲区的长度（以字节为单位）。

ReturnedLength [out]

如果缓冲区足够大，则为输出缓冲区中有效数据的长度（以字节为单位），或者输出缓冲区的所需大小。 如果不存在 CPU 集，此值将为 0。

进程 [in， 可选]

进程的可选句柄。 此过程用于确定 SYSTEM_CPU_SET_INFORMATION 结构中 AllocatedToTargetProcess 标志的值。 如果将 CPU 集分配给指定的进程，则设置 标志。 否则，这是明确的。 此句柄必须具有PROCESS_QUERY_LIMITED_INFORMATION访问权限。 还可以在此处指定 GetCurrentProcess 返回的值。

标志

保留的 必须为 0。

返回值

如果 API 成功，则返回 TRUE。 如果失败，可通过 GetLastError 获取错误原因。 如果信息缓冲区为 NULL 或不够大，则返回错误代码ERROR_INSUFFICIENT_BUFFER。 传递的有效参数和足以容纳所有返回数据的缓冲区时，此 API 不会失败。

要求

要求	值
最低受支持的客户端	Windows 10 [桌面应用 |UWP 应用]
最低受支持的服务器	Windows Server 2016 [桌面应用 |UWP 应用]
标头	Processthreadsapi.h
库	Windows.h
DLL	Kernel32.dll