GetThreadSelectedCpuSetMasks 函数 （processthreadsapi.h）

如果使用 SetThreadSelectedCpuSetMasks 或 SetThreadSelectedCpuSets 设置任何分配，则返回指定线程的显式 CPU 集分配。

Syntax

BOOL GetThreadSelectedCpuSetMasks(
  HANDLE          Thread,
  PGROUP_AFFINITY CpuSetMasks,
  USHORT          CpuSetMaskCount,
  PUSHORT         RequiredMaskCount
);

参数

Thread

指定要查询所选 CPU 集的线程。 此句柄必须具有 PROCESS_QUERY_LIMITED_INFORMATION 访问权限。 还可以在此处指定 GetCurrentProcess 返回的值。

CpuSetMasks

指定一个可选缓冲区，用于检索表示线程所选 CPU 集 的GROUP_AFFINITY 结构列表。

CpuSetMaskCount

指定元素中 CpuSetMasks 数组的大小。

RequiredMaskCount

成功返回时，指定写入数组的关联结构数。 如果数组太小，函数将失败并 ERROR_INSUFFICIENT_BUFFER并将RequiredMaskCount 参数设置为所需的元素数。 所需的元素数始终小于或等于 GetMaximumProcessorGroupCount 返回的最大组计数。

返回值

如果函数成功，则返回值为非零。

如果函数失败，则返回值为零，可以通过调用 GetLastError 来检索扩展错误信息。

如果提供的数组太小，则错误值 ERROR_INSUFFICIENT_BUFFER，RequiredMaskCount 设置为所需的元素数。

注解

如果未设置显式分配， 则 RequiredMaskCount 设置为 0，并且函数成功。

此函数类似于 GetThreadSelectedCpuSets，只不过它使用组相关性而不是 CPU 集 ID 来表示 CPU 集的列表。 这意味着所选 CPU 集的线程映射到其主处理器，并且将在生成的组相关性列表中检索这些处理器。

要求