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 |