Funzione KeSetSystemAffinityThread (wdm.h)
La routine KeSetSystemAffinityThread imposta l'affinità di sistema del thread corrente.
Sintassi
void KeSetSystemAffinityThread(
[in] KAFFINITY Affinity
);
Parametri
[in] Affinity
Oggetto KAFFINITYvariabile tipizzata che specifica la nuova affinità di sistema del thread corrente.
Valore restituito
Nessuno
Osservazioni
L'implementazione di KeSetSystemAffinityThread in Windows 7 e versioni successive di Windows offre compatibilità per i driver scritti per le versioni precedenti di Windows, che non supportano i gruppi di processori. In questa implementazione, KeSetSystemAffinityThread assegna il thread al gruppo 0 e usa la maschera di affinità per specificare un set di processori logici in questo gruppo in cui il thread può essere eseguito.
Se keSetSystemAffinityThread viene chiamato in IRQL <= APC_LEVEL e la chiamata ha esito positivo, la nuova maschera di affinità diventa effettiva immediatamente. Al termine della chiamata, il thread chiamante è già in esecuzione in un processore specificato nella nuova maschera di affinità. Se il KeSetSystemAffinityThread viene chiamato in IRQL = DISPATCH_LEVEL e la chiamata ha esito positivo, la modifica del processore in sospeso viene posticipata fino a quando il chiamante non riduce il valore IRQL seguente DISPATCH_LEVEL.
Fabbisogno
| Requisito | Valore |
|---|---|
| client minimo supportato | Disponibile in Windows 2000 e versioni successive di Windows. Usare KeSetSystemAffinityThread solo nei sistemi prima di Windows Vista. In Windows Vista e versioni successive del sistema operativo Windows usare invece KeSetSystemAffinityThreadEx. |
| piattaforma di destinazione | Universale |
| intestazione | wdm.h (include Wdm.h, Ntddk.h, Ntifs.h) |
| libreria | NtosKrnl.lib |
| dll | NtosKrnl.exe |
| IRQL | <= DISPATCH_LEVEL (vedere la sezione Osservazioni). |
| regole di conformità DDI | HwStorPortProhibitedDDIs(storport), PowerIrpDDis(wdm) |