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.

Retornar valor

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

Um bug marcar ocorrerá se o driver fornecer um identificador de objeto inválido.

Comentários

O método WdfDpcEnqueue adiciona o objeto DPC especificado à fila DPC do sistema, se ainda não estiver 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 a função de retorno de chamada EvtDpcFunc do objeto.

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 uma 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 do método WdfDpcEnqueue como o valor retornado da função que contém. O exemplo de código WdfDpcCreate mostra como o objeto DPC foi criado.

return WdfDpcEnqueue(PDevExt->CompleteWriteDpc);

Requisitos

Confira também

EvtDpcFunc

WdfDpcCreate