Auf Englisch lesen

Freigeben über


KeQueryMaximumProcessorCountEx-Funktion (ntddk.h)

Die KeQueryMaximumProcessorCountEx Routine gibt die maximale Anzahl logischer Prozessoren in einer angegebenen Gruppe in einem Multiprozessorsystem zurück.

Syntax

ULONG KeQueryMaximumProcessorCountEx(
  [in] USHORT GroupNumber
);

Parameter

[in] GroupNumber

Gibt eine Gruppennummer an. Wenn ein Multiprozessorsystem n Gruppen enthält, werden die Gruppen von 0 bis n-1 nummeriert. Um die maximale Anzahl von Prozessoren im System zu erhalten, legen Sie diesen Parameter auf ALL_PROCESSOR_GROUPS fest, der in den Headerdateien Winnt.h und Ntdef.h definiert ist.

Rückgabewert

KeQueryMaximumProcessorCountEx gibt die maximale Anzahl logischer Prozessoren in der angegebenen Gruppe oder im System zurück, wie durch den Wert des GroupNumber-Parameters angegeben.

Bemerkungen

Der von KeQueryMaximumProcessorCountEx zurückgegebene Wert bleibt während der Laufzeit konstant. Dieser Wert hängt von der Hardwarekonfiguration des Multiprozessorsystems ab, kann jedoch niemals einen festen Grenzwert überschreiten, der vom Windows-Betriebssystem festgelegt wird. Dieser Grenzwert beträgt 32 logische Prozessoren für 32-Bit-Versionen von Windows und 64 logische Prozessoren für 64-Bit-Versionen von Windows.

Im Gegensatz dazu kann sich der Wert, der von der KeQueryActiveProcessorCountEx Routine während der Laufzeit zurückgegeben wird, ändern, wenn Prozessoren dynamisch dem System hinzugefügt werden.

Eine verwandte Routine, KeQueryMaximumProcessorCount, gibt eine maximale Prozessoranzahl zurück, aber diese Routine, im Gegensatz zu KeQueryMaximumProcessorCountEx, akzeptiert keine Gruppennummer als Eingabeparameter. In Windows 7 und höheren Versionen des Windows-Betriebssystems gibt KeQueryMaximumProcessorCount die maximale Anzahl logischer Prozessoren in Gruppe 0 zurück, die mit dem Verhalten dieser Routine in früheren Versionen von Windows kompatibel ist, die keine Gruppen unterstützen. Dieses Verhalten stellt sicher, dass vorhandene Treiber, die KeQueryMaximumProcessorCount aufrufen und keine gruppenorientierten Features verwenden, ordnungsgemäß in Multiprozessorsystemen mit zwei oder mehr Gruppen ausgeführt werden. Treiber, die gruppenorientierte Features in Windows 7 und höheren Versionen des Windows-Betriebssystems verwenden, sollten jedoch KeQueryMaximumProcessorCountEx anstelle von KeQueryMaximumProcessorCountaufrufen.

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

Siehe auch

KeQueryActiveProcessorCountEx

KeQueryMaximumProcessorCount