StorPortGetNodeAffinity2-Funktion (storport.h)

Artikel
02/07/2025

Ein Miniport kann StorPortGetNodeAffinity2- aufrufen, um die aktuelle Multigruppenprozessoraffinität des angegebenen NUMA-Knotens abzurufen.

Syntax

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

Parameter

HwDeviceExtension

[in] Zeiger auf die Geräteerweiterung des Miniports.

NodeNumber

[in] Die Knotennummer des zu abfragenden Knotens.

GroupAffinities

[out] Zeigen Sie auf ein Array von GROUP_AFFINITY Strukturen, die nach Erfolg eine Gruppennummer und die Affinitätsmaske der identifizierten Gruppe erhalten.

GroupAffinitiesCount

[in] Die Anzahl der Elemente im Array, auf die GroupAffinities verweist. Wenn das Array zu klein ist, um die Knotenaffinität zu halten, wird STATUS_BUFFER_TOO_SMALL zurückgegeben, und die Anzahl der erforderlichen Elemente wird in GroupAffinitiesRequiredzurückgegeben.

GroupAffinitiesCountRequired

[out] Zeigen Sie auf einen Wert, der die Anzahl der Gruppenaffinitäten empfängt, die erforderlich sind, um die Knotenaffinität darzustellen.

Rückgabewert

StorPortGetNodeAffinity2 gibt STOR_STATUS_SUCCESS zurück, wenn die Knotenaffinität erfolgreich abgefragt wurde. Mögliche Fehlerrückgabewerte sind:

Rückgabecode	Beschreibung
STOR_STATUS_INVALID_PARAMETER	Es gibt einen ungültigen Parameter, z. B. einen ungültigen NodeNumber Wert.
STOR_STATUS_BUFFER_TOO_SMALL	Das bereitgestellte Array ist zu klein.
STOR_STATUS_UNSUCCESSFUL	Aus internen Gründen ist ein Fehler aufgetreten.

Bemerkungen

Weitere Informationen finden Sie im Abschnitt AnmerkungenKeQueryNodeActiveAffinity2.

Anforderungen

Anforderung	Wert
mindestens unterstützte Client-	Windows 11, Version 22H2
Header-	storport.h

Siehe auch

GROUP_AFFINITY

Freigeben über