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) |