KeQueryGroupAffinity-Funktion (ntddk.h)
Die KeQueryGroupAffinity-Routine gibt eine Affinitätsmaske zurück, die die aktiven logischen Prozessoren in einer angegebenen Gruppe in einem Multiprozessorsystem identifiziert.
Syntax
KAFFINITY KeQueryGroupAffinity(
[in] USHORT GroupNumber
);
Parameter
[in] GroupNumber
Die Gruppennummer. Wenn ein Multiprozessorsystem n-Gruppen enthält, werden die Gruppen von 0 bis n-1 nummeriert. Rufen Sie die KeQueryActiveGroupCount-Routine auf, um die Anzahl der aktiven Gruppen im System abzurufen.
Rückgabewert
KeQueryGroupAffinity gibt einen KAFFINITY-Wert zurück, der die aktiven logischen Prozessoren in der angegebenen Gruppe identifiziert. Wenn der GroupNumber-Parameterwert keine gültige Gruppennummer ist, gibt die Routine null zurück.
Hinweise
Eine verwandte Routine, KeQueryActiveProcessors, gibt eine Affinitätsmaske zurück, die einen Satz aktiver Prozessoren darstellt, aber diese Routine akzeptiert im Gegensatz zu KeQueryGroupAffinity keine Gruppennummer als Eingabeparameter. In Windows 7 und höheren Versionen des Windows-Betriebssystems gibt KeQueryActiveProcessors eine Affinitätsmaske für die aktiven 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 KeQueryActiveProcessors 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 KeQueryGroupAffinity anstelle von KeQueryActiveProcessors aufrufen.
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 |