KeQueryGroupAffinity-Funktion (wdm.h)
Die KeQueryGroupAffinity Routine gibt eine Affinitätsmaske zurück, die die aktiven logischen Prozessoren in einer bestimmten 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 zum Abrufen der Anzahl der aktiven Gruppen im System die KeQueryActiveGroupCount Routine auf.
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.
Bemerkungen
Eine verwandte Routine, KeQueryActiveProcessors, gibt eine Affinitätsmaske zurück, die eine Reihe aktiver Prozessoren darstellt, aber diese Routine akzeptiert im Gegensatz zu KeQueryGroupAffinitykeine 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, 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 KeQueryGroupAffinity- anstelle von KeQueryActiveProcessorsaufrufen.
Anforderungen
| Anforderung | Wert |
|---|---|
| mindestens unterstützte Client- | Verfügbar in Windows 7 und höheren Versionen von Windows. |
| Zielplattform- | Universal |
| Header- | wdm.h (include Wdm.h, Ntddk.h, Ntifs.h) |
| Library | NtosKrnl.lib |
| DLL- | NtosKrnl.exe |
| IRQL- | Beliebige Ebene |