Share via

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