KeQueryGroupAffinity-Funktion (ntddk.h)

  • Artikel

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

Weitere Informationen

KAFFINITY

KeQueryActiveProcessors