StorPortGetNodeAffinity2-Funktion (storport.h)

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 abzufragenden Knotens.

GroupAffinities

[out] Zeiger auf ein Array von GROUP_AFFINITY Strukturen, die nach erfolgreichem 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 enthalten, wird STATUS_BUFFER_TOO_SMALL zurückgegeben, und die Anzahl der erforderlichen Elemente wird in GroupAffinitiesRequired zurückgegeben.

GroupAffinitiesCountRequired

[out] Zeiger auf einen Wert, der die Anzahl der Gruppenaffinitäten empfängt, die zur Darstellung der Knotenaffinität erforderlich sind.

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 angegebene Array ist zu klein.
STOR_STATUS_UNSUCCESSFUL	Aus internen Gründen ist ein Fehler aufgetreten.

Hinweise

Weitere Informationen finden Sie im Abschnitt Hinweise von KeQueryNodeActiveAffinity2 .

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 11, Version 22H2
Kopfzeile	storport.h

Weitere Informationen

GROUP_AFFINITY