Funzione KeSetTargetProcessorDpc (ntddk.h)

Articolo
02/26/2024

La routine KeSetTargetProcessorDpc specifica il processore in cui verrà eseguita una routine DPC.

Sintassi

void KeSetTargetProcessorDpc(
  [in, out] PRKDPC Dpc,
  [in]      CCHAR  Number
);

Parametri

[in, out] Dpc

Puntatore all'oggetto DPC del chiamante, che KeInitializeDpc già inizializzato.

[in] Number

Specifica il numero in base zero del processore di destinazione in cui il DPC deve essere accodato ed eseguito.

Valore restituito

nessuno

Osservazioni

Nei sistemi multiprocessore ogni processore ha la propria coda DPC. La routine KeSetTargetProcessorDpc specifica quale coda del processore deve usare quando il driver chiama KeInsertQueueDpc o IoRequestDpc per accodare un DPC da eseguire in un secondo momento.

A partire da Windows Vista, è anche possibile usare KeSetTargetProcessorDpc per specificare il processore di destinazione per i dpc thread.

Una chiamata a KeSetTargetProcessorDpc che si verifica dopo la coda di un oggetto DPC non ha alcun effetto sulla selezione di un processore per l'esecuzione della routine DPC. Per controllare la selezione del processore di destinazione, è necessario che venga eseguita una chiamata KeSetTargetProcessorDpc prima della chiamata a KeInsertQueueDpc o IoRequestDpc che accoda l'oggetto DPC.

Per altre informazioni sulle code DPC, vedere Organizzazione di code DPC.

Windows 7 e versioni successive dei gruppi di processori di supporto di Windows. I driver progettati per gestire le informazioni sui gruppi di processori devono usare la routine KeSetTargetProcessorDpcEx , che specifica un gruppo di processori, anziché KeSetTargetProcessorDpc, che non è. Tuttavia, l'implementazione di KeSetTargetProcessorDpc in Windows 7 e versioni successive di Windows offre la compatibilità per i driver scritti per le versioni precedenti di Windows, che non supportano i gruppi di processori. In questa implementazione, se Number è minore del numero di processori logici attivi nel gruppo 0, KeSetTargetProcessorDpc imposta la destinazione per il DPC al processore nel gruppo 0 specificato da Number. In caso contrario, la destinazione DPC non cambia.

Requisiti

Requisito	Valore
Client minimo supportato	Disponibile a partire da Windows 2000.
Piattaforma di destinazione	Universale
Intestazione	ntddk.h (include Wdm.h, Ntddk.h, Ntifs.h)
Libreria	NtosKrnl.lib
DLL	NtosKrnl.exe
IRQL	Qualsiasi livello