Função WdfDpcEnqueue (wdfdpc.h)

[Aplica-se somente ao KMDF]

O método WdfDpcEnqueue agenda a execução da função de retorno de chamada EvtDpcFunc de um objeto DPC.

Sintaxe

BOOLEAN WdfDpcEnqueue(
  [in] WDFDPC Dpc
);

Parâmetros

[in] Dpc

Um identificador para um objeto DPC de estrutura.

Valor de retorno

WdfDpcEnqueue retornará verdadeiro se adicionar com êxito o objeto DPC especificado à fila DPC do sistema. Caso contrário, o método retornará FALSE.

Uma verificação de bug ocorre se o driver fornece um identificador de objeto inválido.

Observações

O método WdfDpcEnqueue adiciona o objeto DPC especificado à fila DPC do sistema, caso ainda não esteja na fila. (Se o objeto DPC já estava na fila, o método retorna FALSE.) Quando o sistema não está executando tarefas de prioridade mais alta, ele remove o objeto DPC da fila e chama o objeto EvtDpcFunc função de retorno de chamada.

Após a execução da função de retorno de chamada, uma chamada subsequente para WdfDpcEnqueue adicionará o objeto DPC de volta à fila DPC.

Para obter mais informações sobre como usar objetos DPC, consulte Manutenção de umde Interrupção.

Exemplos

O exemplo de código a seguir agenda a execução da função de retorno de chamada associada a um objeto DPC. O exemplo usa o valor retornado WdfDpcEnqueue método como o valor retornado da função independente. O exemplo de código WdfDpcCreate mostra como o objeto DPC foi criado.

return WdfDpcEnqueue(PDevExt->CompleteWriteDpc);

Requisitos

Consulte também

EvtDpcFunc

WdfDpcCreate