Função KeSetTargetProcessorDpc (wdm.h)
A rotina KeSetTargetProcessorDpc especifica o processador no qual uma rotina de DPC será executada.
Sintaxe
void KeSetTargetProcessorDpc(
[in, out] PRKDPC Dpc,
[in] CCHAR Number
);
Parâmetros
[in, out] Dpc
Ponteiro para o objeto DPC do chamador, que KeInitializeDpc já inicializado.
[in] Number
Especifica o número baseado em zero do processador de destino no qual o DPC deve ser enfileirado e executado.
Valor de retorno
Nenhum
Observações
Em sistemas multiprocessadores, cada processador tem sua própria fila de DPC. A rotina de KeSetTargetProcessorDpc especifica qual fila do processador o sistema deve usar quando o driver chama KeInsertQueueDpc ou IoRequestDpc para enfileirar um DPC para ser executado posteriormente.
A partir do Windows Vista, você também pode usar KeSetTargetProcessorDpc para especificar o processador de destino para de DPCs encadeados.
Uma chamada para keSetTargetProcessorDpcEx que ocorre depois que um objeto DPC foi enfileirado não tem efeito na seleção de um processador para a rotina DPC a ser executada. Para controlar a seleção do processador de destino, uma chamada KeSetTargetProcessorDpc deve ocorrer antes da chamada para KeInsertQueueDpc ou IoRequestDpc que enfileira o objeto DPC.
Para obter mais informações sobre filas DPC, consulte Organização de Filas DPC.
O Windows 7 e versões posteriores do Windows dão suporte a grupos de processadores. Os drivers projetados para lidar com informações sobre grupos de processadores devem usar a rotina KeSetTargetProcessorDpcEx, que especifica um grupo de processadores, em vez de KeSetTargetProcessorDpc, o que não acontece. No entanto, a implementação de keSetTargetProcessorDpc no Windows 7 e versões posteriores do Windows fornece compatibilidade para drivers que foram gravados para versões anteriores do Windows, que não dão suporte a grupos de processadores. Nesta implementação, se Number for menor que o número de processadores lógicos ativos no grupo 0, KeSetTargetProcessorDpc definirá o destino do DPC para o processador no grupo 0 especificado por Number. Caso contrário, o destino DPC não será alterado.
Requisitos
| Requisito | Valor |
|---|---|
| de cliente com suporte mínimo | Disponível a partir do Windows 2000. |
| da Plataforma de Destino | Universal |
| cabeçalho | wdm.h (include Wdm.h, Ntddk.h, Ntifs.h) |
| biblioteca | NtosKrnl.lib |
| de DLL | NtosKrnl.exe |
| IRQL | Qualquer nível |