Função WdfDpcWdmGetDpc (wdfdpc.h)
[Aplica-se somente ao KMDF]
O método WdfDpcWdmGetDpc retorna um ponteiro para a estrutura KDPC que está associada a um objeto DPC de estrutura especificado.
Sintaxe
PKDPC WdfDpcWdmGetDpc(
[in] WDFDPC Dpc
);
Parâmetros
[in] Dpc
Um identificador para um objeto DPC de estrutura.
Valor de retorno
WdfDpcWdmGetDpc retorna um ponteiro para a estrutura KDPC associada ao objeto DPC da estrutura especificado.
Uma verificação de bug ocorre se o driver fornece um identificador de objeto inválido.
Observações
A estrutura cria uma estrutura KDPC quando um driver baseado em estrutura chama WdfDpcCreate para criar um objeto DPC.
Um driver pode chamar WdfDpcWdmGetDpc de dentro de sua função de retorno de chamada EvtDpcFunc.
O ponteiro que WdfDpcWdmGetDpc retorna é válido até que o objeto DPC da estrutura seja excluído. Se o driver fornecer uma função EvtCleanupCallback para o objeto DPC da estrutura, o ponteiro será válido até que a função de retorno de chamada retorne.
Exemplos
O exemplo de código a seguir retorna um ponteiro para a estrutura de KDPC associada a um objeto DPC especificado. O exemplo de código WdfDpcCreate mostra como o objeto DPC especificado foi criado.
PKDPC pWdmDpc;
pWdmDpc = WdfDpcWdmGetDpc(PDevExt->CompleteWriteDpc);
Requisitos
| Requisito | Valor |
|---|---|
| da Plataforma de Destino | Universal |
| versão mínima do KMDF | 1.0 |
| cabeçalho | wdfdpc.h (inclua Wdf.h) |
| Biblioteca | Wdf01000.sys (consulte o Controle de Versão da Biblioteca da Estrutura.) |
| IRQL | Qualquer nível |
| regras de conformidade de DDI | DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf) |