Funzione KeQueryGroupAffinity (wdm.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 | wdm.h (include Wdm.h, Ntddk.h, Ntifs.h) |
| Libreria | NtosKrnl.lib |
| DLL | NtosKrnl.exe |
| IRQL | Qualsiasi livello |