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 |