StorPortGetNodeAffinity2, fonction (storport.h)
Un miniport peut appeler StorPortGetNodeAffinity2 pour obtenir l’affinité actuelle du processeur multi-groupe 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 points. 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 de retour
StorPortGetNodeAffinity2 retourne STOR_STATUS_SUCCESS si l’affinité de nœud a été interrogée avec succès. Les valeurs de retour d’erreur possibles sont les suivantes.
| Retourner le code | 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 KeQueryNodeActiveAffinity 2.
Exigences
| Exigence | Valeur |
|---|---|
| client minimum pris en charge | Windows 11, version 22H2 |
| d’en-tête | storport.h |