KeQueryMaximumProcessorCountEx-Funktion (ntddk.h)
Die KeQueryMaximumProcessorCountEx Routine gibt die maximale Anzahl logischer Prozessoren in einer angegebenen Gruppe in einem Multiprozessorsystem zurück.
ULONG KeQueryMaximumProcessorCountEx(
[in] USHORT GroupNumber
);
[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.
KeQueryMaximumProcessorCountEx gibt die maximale Anzahl logischer Prozessoren in der angegebenen Gruppe oder im System zurück, wie durch den Wert des GroupNumber-Parameters angegeben.
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.
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 |