StorPortGetNodeAffinity2 函数 (storport.h)

微型端口可以调用 StorPortGetNodeAffinity2 ,以获取给定 NUMA 节点的当前多组处理器相关性。

语法

ULONG StorPortGetNodeAffinity2(
  PVOID           HwDeviceExtension,
  ULONG           NodeNumber,
  PGROUP_AFFINITY GroupAffinities,
  USHORT          GroupAffinitiesCount,
  PUSHORT         GroupAffinitiesCountRequired
);

参数

HwDeviceExtension

[in]指向微型端口设备扩展的指针。

NodeNumber

[in]要查询的节点的节点号。

GroupAffinities

[out]指向 GROUP_AFFINITY 结构的数组的指针,这些结构在成功后接收已标识组的组号和关联掩码。

GroupAffinitiesCount

[in] GroupAffinities 指向的数组中的元素数。 如果数组太小而无法保存节点相关性,则返回STATUS_BUFFER_TOO_SMALL,并在 GroupAffinitiesRequired 中返回所需的元素数。

GroupAffinitiesCountRequired

[out]指向一个值的指针,该值接收表示节点相关性所需的组相关性数。

返回值

如果成功查询节点相关性,StorPortGetNodeAffinity2 将返回STOR_STATUS_SUCCESS。 可能的错误返回值包括以下内容。

返回代码 说明
STOR_STATUS_INVALID_PARAMETER 存在无效参数,例如无效 的 NodeNumber 值。
STOR_STATUS_BUFFER_TOO_SMALL 提供的数组太小。
STOR_STATUS_UNSUCCESSFUL 由于内部原因,发生了错误。

注解

有关详细信息,请参阅 KeQueryNodeActiveAffinity2“备注”部分。

要求

要求
最低受支持的客户端 Windows 11 版本 22H2
标头 storport.h

另请参阅

GROUP_AFFINITY