Partilhar via


Função WdfDriverWdmGetDriverObject (wdfdriver.h)

[Aplica-se somente ao KMDF]

O método WdfDriverWdmGetDriverObject recupera um ponteiro para o objeto de driver WDM (Windows Driver Model) associado a um objeto de driver de estrutura especificado.

Sintaxe

PDRIVER_OBJECT WdfDriverWdmGetDriverObject(
  [in] WDFDRIVER Driver
);

Parâmetros

[in] Driver

Um identificador para o objeto de driver da estrutura do driver que o driver obteve de uma chamada anterior para wdfDriverCreate ou WdfGetDriver.

Valor de retorno

WdfDriverWdmGetDriverObject retorna um ponteiro para uma estrutura DRIVER_OBJECT. Uma verificação de bugs do sistema ocorre se o identificador de do Driver for inválido.

Observações

O ponteiro que o método WdfDriverWdmGetDriverObject retorna é válido até que o objeto de driver da estrutura seja excluído. Se o driver fornecer uma função EvtCleanupCallback para o objeto de driver 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 obtém um ponteiro para o objeto de driver do WDM associado a um objeto de driver de estrutura especificado.

PDRIVER_OBJECT  pDrvObj;

pDrvObj = WdfDriverWdmGetDriverObject(Driver);

Requisitos

Requisito Valor
da Plataforma de Destino Universal
versão mínima do KMDF 1.0
cabeçalho wdfdriver.h (inclua Wdf.h)
Biblioteca Wdf01000.sys (consulte o Controle de Versão da Biblioteca da Estrutura.)
IRQL <= DISPATCH_LEVEL
regras de conformidade de DDI DriverCreate(kmdf)

Consulte também

DRIVER_OBJECT

WdfDriverCreate

do WdfGetDriver