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

Requisito	Valor
Plataforma de Destino	Universal
Versão mínima do KMDF	1.0
Cabeçalho	wdfdpc.h (inclua Wdf.h)
Biblioteca	Wdf01000.sys (consulte Controle de versão da biblioteca de estrutura.)
IRQL	Qualquer nível
Regras de conformidade de DDI	DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf)

Confira também

EvtDpcFunc

WdfDpcCreate