Freigeben über


KeQueryActiveGroupCount-Funktion (wdm.h)

Die KeQueryActiveGroupCount-Routine gibt die Anzahl der aktiven Prozessorgruppen in einem Multiprozessorsystem zurück.

Syntax

USHORT KeQueryActiveGroupCount();

Rückgabewert

KeQueryActiveGroupCount gibt die Anzahl der aktiven Gruppen zurück.

Hinweise

Eine Prozessorgruppe ist aktiv, wenn sie einen oder mehrere aktive logische Prozessoren enthält.

Ein aktiver logischer Prozessor ist ein logischer Prozessor, den Windows gestartet und einem Multiprozessorsystem hinzugefügt hat. Der Begriff aktiver Prozessor gilt für einen Prozessor, der für die Ausführung von Verarbeitungsvorgängen verfügbar ist, unabhängig davon, ob der Prozessor derzeit Verarbeitungsarbeiten ausführt oder sich im Leerlauf befindet. In einigen Systemen kann die Anzahl der aktiven Prozessoren vom Systemstart bis zum Herunterfahren unverändert bleiben. In anderen Systemen fügt Windows während der Systemausführung möglicherweise dynamisch aktive Prozessoren hinzu. Windows entfernt nie aktive Prozessoren aus einem System.

Daher kann die Anzahl der aktiven Prozessoren in einem Multiprozessorsystem zwischen Systemstart und -herunterfahren zunehmen, aber diese Zahl nimmt nie ab. Ebenso kann die Anzahl der aktiven Gruppen im System zunehmen, wenn ein Prozessor dynamisch zu einer inaktiven Gruppe hinzugefügt wird, während das System ausgeführt wird. Die Anzahl der aktiven Gruppen nimmt nie ab.

Im Gegensatz dazu bleibt der von KeQueryMaximumGroupCount zurückgegebene Wert während der Laufzeit konstant. Dieser Wert ist die maximale Anzahl von Gruppen, die das System haben kann.

Rufen Sie die KeQueryActiveProcessorCountEx-Routine auf, um die Anzahl der aktiven logischen Prozessoren in einer bestimmten Gruppe zu bestimmen.

Windows 7 ist die erste Version von Windows, die Prozessorgruppen unterstützt. In Windows 7 unterstützen nur 64-Bit-Versionen von Windows mehrere Gruppen. 32-Bit-Versionen von Windows unterstützen nur eine Gruppe. Wenn auf einem Multiprozessorsystem eine 64-Bit-Version von Windows ausgeführt wird und nicht mehr als 64 logische Prozessoren enthalten sind, weist Windows der Gruppe 0 alle Prozessoren zu. Ein Multiprozessorsystem, auf dem eine 32-Bit-Version von Windows ausgeführt wird, darf nicht mehr als 32 Prozessoren enthalten.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Verfügbar ab Windows 7.
Zielplattform Universell
Header wdm.h (include Ntddk.h, Wdm.h, Ntddk.h)
Bibliothek NtosKrnl.lib
DLL NtosKrnl.exe
IRQL Beliebige Ebene

Weitere Informationen

KeQueryActiveProcessorCountEx

KeQueryMaximumGroupCount