Compartilhar via


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)

Consulte também

EvtDpcFunc

KDPC

WDF_DPC_CONFIG

WdfDpcCreate