Funzione StorPortGetNodeAffinity2 (storport.h)

Un miniport può chiamare StorPortGetNodeAffinity2 per ottenere l'affinità corrente del processore multigruppo del nodo NUMA specificato.

Sintassi

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

Parametri

HwDeviceExtension

[in] Puntatore all'estensione del dispositivo miniport.

NodeNumber

[in] Numero di nodo del nodo su cui eseguire una query.

GroupAffinities

[out] Puntatore a una matrice di strutture GROUP_AFFINITY che, in caso di esito positivo, ricevono un numero di gruppo e la maschera di affinità del gruppo identificato.

GroupAffinitiesCount

[in] Numero di elementi nella matrice a cui GroupAffinities punta. Se la matrice è troppo piccola per contenere l'affinità del nodo, viene restituita STATUS_BUFFER_TOO_SMALL e il numero di elementi necessari viene restituito in GroupAffinitiesRequired.

GroupAffinitiesCountRequired

[out] Puntatore a un valore che riceve il numero di affinità di gruppo necessarie per rappresentare l'affinità del nodo.

Valore restituito

StorPortGetNodeAffinity2 restituisce STOR_STATUS_SUCCESS se l'affinità del nodo è stata eseguita correttamente. I valori restituiti di errore possibili includono quanto segue.

Codice restituito Descrizione
STOR_STATUS_INVALID_PARAMETER Esiste un parametro non valido, ad esempio un valore nodeNum ber non valido.
STOR_STATUS_BUFFER_TOO_SMALL La matrice fornita è troppo piccola.
STOR_STATUS_UNSUCCESSFUL Si è verificato un errore per motivi interni.

Osservazioni

Per informazioni dettagliate, vedere la sezione osservazioni di KeQueryNodeActiveAffinity2.

Fabbisogno

Requisito Valore
client minimo supportato Windows 11, versione 22H2
intestazione storport.h

Vedere anche

GROUP_AFFINITY