KeQueryHighestNodeNumber-Funktion (ntddk.h)

Die KeQueryHighestNodeNumber-Routine gibt die höchste Knotenzahl in einem Multiprozessorsystem zurück, das über eine NUMA-Architektur (Non-Uniform Memory Access) verfügt.

Syntax

USHORT KeQueryHighestNodeNumber();

Rückgabewert

KeQueryHighestNodeNumber gibt die höchste Knotenzahl zurück.

Hinweise

In einer NUMA-Multiprozessorarchitektur (Non-Uniform Memory Access) ist ein Knoten eine Sammlung von Prozessoren, die den schnellen Zugriff auf eine Speicherregion gemeinsam nutzen. Der Arbeitsspeicherzugriff ist nicht einheitlich, da ein Prozessor schneller auf den Arbeitsspeicher in seinem Knoten zugreifen kann als auf den Arbeitsspeicher in anderen Knoten.

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 nicht über eine NUMA-Architektur verfügt, gibt KeQueryHighestNodeNumber null zurück. Ein Beispiel für eine Nicht-NUMA-Architektur ist ein symmetrisches Multiprozessorsystem (SMP).

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

Nachdem das System initialisiert wurde, bleibt die Knotenanzahl festgelegt, während das System weiterhin ausgeführt wird. Diese Anzahl kann nur Arbeitsspeicherknoten enthalten, d. h. Knoten, die Arbeitsspeicher, aber keine aktiven logischen Prozessoren enthalten.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Verfügbar in Windows 7 und späteren Windows-Versionen.
Zielplattform	Universell
Header	ntddk.h (include Wdm.h, Ntddk.h, Ntifs.h)
Bibliothek	NtosKrnl.lib
DLL	NtosKrnl.exe
IRQL	Beliebige Ebene