Funzione KeSetSystemAffinityThread (wdm.h)
La routine KeSetSystemAffinityThread imposta l'affinità di sistema del thread corrente.
Sintassi
void KeSetSystemAffinityThread(
[in] KAFFINITY Affinity
);
Parametri
[in] Affinity
Variabile tipizzata KAFFINITY 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 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 abbassa irQL sotto DISPATCH_LEVEL.
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato | Disponibile in Windows 2000 e versioni successive di Windows. Usare KeSetSystemAffinityThread solo nei sistemi precedenti a 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) |