StorPortGetNodeAffinity2, fonction (storport.h)

Article
02/29/2024

Un miniport peut appeler StorPortGetNodeAffinity2 pour obtenir l’affinité processeur multi-groupes actuelle du nœud NUMA donné.

Syntaxe

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

Paramètres

HwDeviceExtension

[in] Pointeur vers l’extension d’appareil du miniport.

NodeNumber

[in] Numéro de nœud du nœud à interroger.

GroupAffinities

[out] Pointeur vers un tableau de structures GROUP_AFFINITY qui, en cas de réussite, reçoivent un numéro de groupe et le masque d’affinité du groupe identifié.

GroupAffinitiesCount

[in] Nombre d’éléments dans le tableau vers lequel GroupAffinities pointe. Si le tableau est trop petit pour contenir l’affinité de nœud, STATUS_BUFFER_TOO_SMALL est retourné et le nombre d’éléments requis est retourné dans GroupAffinitiesRequired.

GroupAffinitiesCountRequired

[out] Pointeur vers une valeur qui reçoit le nombre d’affinités de groupe requises pour représenter l’affinité de nœud.

Valeur retournée

StorPortGetNodeAffinity2 retourne STOR_STATUS_SUCCESS si l’affinité de nœud a été correctement interrogée. Les valeurs de retour d’erreur possibles sont les suivantes.

Code de retour	Description
STOR_STATUS_INVALID_PARAMETER	Il existe un paramètre non valide, tel qu’une valeur NodeNumber non valide.
STOR_STATUS_BUFFER_TOO_SMALL	Le tableau fourni est trop petit.
STOR_STATUS_UNSUCCESSFUL	Une erreur s’est produite pour des raisons internes.

Remarques

Pour plus d’informations, consultez la section Remarques de KeQueryNodeActiveAffinity2 .

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows 11, version 22H2
En-tête	storport.h

Voir aussi

GROUP_AFFINITY

Partager via