Função WdfDpcWdmGetDpc (wdfdpc.h)
[Aplica-se somente ao KMDF]
O método WdfDpcWdmGetDpc retorna um ponteiro para a estrutura KDPC 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.
Retornar valor
WdfDpcWdmGetDpc retorna um ponteiro para a estrutura KDPC associada ao objeto DPC de estrutura especificado.
Um bug marcar ocorrerá se o driver fornecer um identificador de objeto inválido.
Comentários
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 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 |
|---|---|
| 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 da DDI | DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf) |