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 del miniport.

NodeNumber

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

GroupAffinities

[out] Puntatore a una matrice di GROUP_AFFINITY strutture 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 NodeNumber non valido.
STOR_STATUS_BUFFER_TOO_SMALL La matrice fornita è troppo piccola.
STOR_STATUS_UNSUCCESSFUL Si è verificato un errore per motivi interni.

Commenti

Per informazioni dettagliate, vedere la sezione Osservazioni di KeQueryNodeActiveAffinity2 .

Requisiti

Requisito Valore
Client minimo supportato Windows 11 versione 22H2
Intestazione storport.h

Vedi anche

GROUP_AFFINITY