Funzione KeQueryHighestNodeNumber (ntddk.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-Uniform Memory Access), 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 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 dispone di 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 più processori logici di quanto si 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 solo memoria, ovvero nodi che contengono memoria, ma non processori logici attivi.

Requisiti

Requisito	Valore
Client minimo supportato	Disponibile in Windows 7 e versioni successive di Windows.
Piattaforma di destinazione	Universale
Intestazione	ntddk.h (include Wdm.h, Ntddk.h, Ntifs.h)
Libreria	NtosKrnl.lib
DLL	NtosKrnl.exe
IRQL	Qualsiasi livello