KeQueryMaximumProcessorCountEx-Funktion (wdm.h)

  • Artikel

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 abzurufen, 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.

Hinweise

Der von KeQueryMaximumProcessorCountEx zurückgegebene Wert bleibt während der Laufzeit konstant. Dieser Wert hängt von der Hardwarekonfiguration des Multiprozessorsystems ab, darf aber 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 Von der KeQueryActiveProcessorCountEx-Routine zurückgegebene Wert während der Laufzeit ändern, wenn Prozessoren dynamisch zum System hinzugefügt werden.

Eine verwandte Routine, KeQueryMaximumProcessorCount, gibt eine maximale Prozessoranzahl zurück, aber diese Routine akzeptiert im Gegensatz zu KeQueryMaximumProcessorCountEx 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, in Multiprozessorsystemen mit zwei oder mehr Gruppen ordnungsgemäß ausgeführt werden. Treiber, die gruppenorientierte Features in Windows 7 und höheren Versionen des Windows-Betriebssystems verwenden, sollten jedoch KeQueryMaximumProcessorCountEx anstelle von KeQueryMaximumProcessorCount aufrufen.

Anforderungen

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

Weitere Informationen

KeQueryActiveProcessorCountEx

KeQueryMaximumProcessorCount