KeQueryHighestNodeNumber-Funktion (ntddk.h)

Die KeQueryHighestNodeNumber Routine gibt die höchste Knotennummer in einem Multiprozessorsystem zurück, das über eine nicht einheitliche Speicherzugriffsarchitektur (NUMA) verfügt.

Syntax

USHORT KeQueryHighestNodeNumber();

Rückgabewert

KeQueryHighestNodeNumber gibt die höchste Knotennummer zurück.

Bemerkungen

Bei einer nicht uniform memory access (NUMA)-Multiprozessorarchitektur ist ein Knoten eine Sammlung von Prozessoren, die schnellen Zugriff auf einen Speicherbereich freigeben. Der Speicherzugriff ist nicht einheitlich, da ein Prozessor schneller auf den Speicher in seinem Knoten zugreifen kann, als er auf den Speicher in anderen Knoten zugreifen kann.

Wenn ein NUMA-Multiprozessorsystem n Knoten enthält, werden die Knoten von 0 bis n-1 nummeriert, und KeQueryHighestNodeNumber gibt n-1 zurück. Wenn ein System einen Knoten enthält, gibt KeQueryHighestNodeNumber Null zurück.

Wenn ein System keine NUMA-Architektur aufweist, gibt KeQueryHighestNodeNumber Null zurück. Ein Beispiel für eine Nicht-NUMA-Architektur ist ein symmetrisches Multiprozessorsystem (SMP).

Wenn Windows ein NUMA-Multiprozessorsystem initialisiert, wird logischen Prozessoren Knoten zugewiesen und die Anzahl der resultierenden Knoten gezählt. Windows definiert die Kapazität eines Knotens als die Anzahl der Prozessoren, die vorhanden sind, wenn das System gestartet wird, zusätzlich zu allen anderen logischen Prozessoren, die während der Ausführung des Systems dem Knoten hinzugefügt werden können. Wenn Windows während der Initialisierung auf einen NUMA-Hardwareknoten trifft, der mehr logische Prozessoren enthält, als in eine Gruppe passen, teilt Windows den Knoten in kleinere logische Knoten auf. Jeder dieser Knoten überschreitet nicht die maximale Gruppengröße. Der Wert, der von KeQueryHighestNodeNumber zurückgegeben wird, gibt die Anzahl der logischen Knoten im System an.

Nachdem das System initialisiert wurde, bleibt die Knotenanzahl fest, während das System weiterhin ausgeführt wird. Diese Anzahl kann nur Speicherknoten umfassen, bei denen es sich um Knoten handelt, die Arbeitsspeicher enthalten, aber keine aktiven logischen Prozessoren.

Anforderungen

Anforderung	Wert
mindestens unterstützte Client-	Verfügbar in Windows 7 und höheren Versionen von Windows.
Zielplattform-	Universal
Header-	ntddk.h (enthalten Wdm.h, Ntddk.h, Ntifs.h)
Library	NtosKrnl.lib
DLL-	NtosKrnl.exe
IRQL-	Beliebige Ebene