Função WdfDpcWdmGetDpc (wdfdpc.h)

  • Artigo

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

Confira também

EvtDpcFunc

KDPC

WDF_DPC_CONFIG

WdfDpcCreate