Funzione KeQueryGroupAffinity (ntddk.h)

La routine KeQueryGroupAffinity restituisce una maschera di affinità che identifica i processori logici attivi in un gruppo specificato in un sistema multiprocessore.

Sintassi

KAFFINITY KeQueryGroupAffinity(
  [in] USHORT GroupNumber
);

Parametri

[in] GroupNumber

Numero del gruppo. Se un sistema multiprocessore contiene n gruppi, i gruppi vengono numerati da 0 a n-1. Per ottenere il numero di gruppi attivi nel sistema, chiamare la routine KeQueryActiveGroupCount .

Valore restituito

KeQueryGroupAffinity restituisce un valore KAFFINITY che identifica i processori logici attivi nel gruppo specificato. Se il valore del parametro GroupNumber non è un numero di gruppo valido, la routine restituisce zero.

Commenti

Una routine correlata, KeQueryActiveProcessors, restituisce una maschera di affinità che rappresenta un set di processori attivi, ma questa routine, diversamente da KeQueryGroupAffinity, non accetta un numero di gruppo come parametro di input. In Windows 7 e versioni successive del sistema operativo Windows , KeQueryActiveProcessors restituisce una maschera di affinità per i processori attivi nel gruppo 0, compatibile con il comportamento di questa routine nelle versioni precedenti di Windows che non supportano i gruppi. Questo comportamento garantisce che i driver esistenti che chiamano KeQueryActiveProcessors e che non usino funzionalità orientate ai gruppi vengano eseguite correttamente nei sistemi multiprocessore con due o più gruppi. Tuttavia, i driver che usano funzionalità orientate ai gruppi in Windows 7 e versioni successive del sistema operativo Windows devono chiamare KeQueryGroupAffinity anziché KeQueryActiveProcessors.

Requisiti

Requisito	Valore
Client minimo supportato	Disponibile in Windows 7 e versioni successive di Windows.
Piattaforma di destinazione	Universale
Intestazione	ntddk.h (include Wdm.h, Ntddk.h, Ntifs.h)
Libreria	NtosKrnl.lib
DLL	NtosKrnl.exe
IRQL	Qualsiasi livello

Vedi anche

KAFFINITY

KeQueryActiveProcessors