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 di gruppo. Se un sistema multiprocessore contiene n gruppi di, 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.
Osservazioni
Una routine correlata, KeQueryActiveProcessors, restituisce una maschera di affinità che rappresenta un set di processori attivi, ma questa routine, a differenza di 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 qualsiasi funzionalità orientata ai gruppi in Windows 7 e versioni successive del sistema operativo Windows devono chiamare KeQueryGroupAffinity anziché KeQueryActiveProcessors.
Fabbisogno
| 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 |