Funzione KeSetSystemAffinityThread (wdm.h)

  • Articolo

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)

Vedi anche

KAFFINITY

KeSetSystemAffinityThreadEx