Funzione KeQueryHighestNodeNumber (wdm.h)

La routine KeQueryHighestNodeNumber restituisce il numero di nodo più alto in un sistema multiprocessore con un'architettura NUMA (Non Uniform Memory Access).

Sintassi

USHORT KeQueryHighestNodeNumber();

Valore restituito

KeQueryHighestNodeNumber restituisce il numero di nodo più alto.

Commenti

In un'architettura multiprocessore (NUMA) non uniforme, un nodo è una raccolta di processori che condividono l'accesso rapido a un'area di memoria. L'accesso alla memoria non è uniforme perché un processore può accedere alla memoria nel suo nodo più velocemente di quanto possa accedere alla memoria in altri nodi.

Se un sistema multiprocessore NUMA contiene n nodi, i nodi vengono numerati da 0 a n-1 e KeQueryHighestNodeNumber restituisce n-1. Se un sistema contiene un nodo, KeQueryHighestNodeNumber restituisce zero.

Se un sistema non ha un'architettura NUMA, KeQueryHighestNodeNumber restituisce zero. Un esempio di architettura non NUMA è un sistema multiprocessore simmetrico (SMP).

Quando Windows inizializza un sistema multiprocessore NUMA, assegna processori logici ai nodi e conta il numero di nodi risultanti. Windows definisce la capacità di un nodo come numero di processori presenti all'avvio del sistema oltre ad altri processori logici che possono essere aggiunti al nodo mentre il sistema è in esecuzione. Se, durante l'inizializzazione, Windows rileva un nodo hardware NUMA che contiene processori logici più adatti a un gruppo, Windows suddivide il nodo in nodi logici più piccoli. Ognuno di questi nodi non supera le dimensioni massime del gruppo. Il valore restituito da KeQueryHighestNodeNumber indica il numero di nodi logici nel sistema.

Dopo l'inizializzazione del sistema, il conteggio dei nodi rimane fisso mentre il sistema continua a essere eseguito. Questo conteggio può includere nodi di sola memoria, ovvero nodi che contengono memoria ma non processori logici attivi.

Requisiti