GetNumaNodeProcessorMask2 函数（systemtopologyapi.h）

检索指定节点的多组处理器掩码。

Syntax

BOOL GetNumaNodeProcessorMask2(
  USHORT          NodeNumber,
  PGROUP_AFFINITY ProcessorMasks,
  USHORT          ProcessorMaskCount,
  PUSHORT         RequiredMaskCount
);

参数

NodeNumber

为感兴趣的节点提供从零开始的节点编号。

ProcessorMasks

一个由GROUP_AFFINITY结构构成的数组，在成功返回时会描述指定节点的处理器掩码。

数组中的每个元素描述属于单个处理器组中节点的一组处理器。 此节点在其中具有活动处理器的每个处理器组的生成的数组中将有一个元素。

ProcessorMaskCount

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

RequiredMaskCount

成功返回时，指定写入数组的关联结构数。

如果输入数组太小，则函数会失败并 ERROR_INSUFFICIENT_BUFFER 并将 RequiredMaskCount 参数设置为所需的元素数。

所需的元素数始终小于或等于 GetMaximumProcessorGroupCount 返回的最大组计数。

返回值

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

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

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

如果提供的 NodeNumber 无效（即大于 GetNumaHighestNodeNumber 返回的值），则错误值 ERROR_INVALID_PARAMETER。

注解

如果指定的节点没有与之关联的任何处理器（即它仅包含内存或外围设备），则返回 的 RequiredMaskCount 将为 0，并且不会将任何结构写入数组。

要求

另请参阅

GetMaximumProcessorGroupCount