getNumaNodeProcessorMask2 函数 (systemtopologyapi.h)

  • 项目

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

语法

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，并且不会将任何结构写入数组。

要求

   
最低受支持的客户端 Windows 10内部版本 20348
最低受支持的服务器 Windows 10内部版本 20348
标头 systemtopologyapi.h

另请参阅

GetMaximumProcessorGroupCount