Função WdfDeviceWdmGetDeviceObject (wdfdevice.h)

  • Artigo

[Aplica-se somente ao KMDF]

O método WdfDeviceWdmGetDeviceObject retorna o objeto de dispositivo WDM (Modelo de Driver do Windows) associado a um objeto de dispositivo de estrutura especificado.

Sintaxe

PDEVICE_OBJECT WdfDeviceWdmGetDeviceObject(
  WDFDEVICE Device
);

Parâmetros

Device

Um identificador para um objeto de dispositivo de estrutura.

Retornar valor

WdfDeviceWdmGetDeviceObject retorna um ponteiro para uma estrutura DEVICE_OBJECT .

Um bug marcar ocorrerá se o driver fornecer um identificador de objeto inválido.

Comentários

O ponteiro que o método WdfDeviceWdmGetDeviceObject retorna é válido até que o objeto de dispositivo da estrutura seja excluído. Se o driver fornecer uma função EvtCleanupCallback para o objeto de dispositivo de estrutura, o ponteiro será válido até que a função de retorno de chamada retorne.

Exemplos

O exemplo de código a seguir cria uma mensagem de rastreamento que contém ponteiros para os objetos do dispositivo WDM que representam o PDO e o FDO de um dispositivo.

TraceEvents(
            TRACE_LEVEL_INFORMATION,
            AMCC_TRACE_INIT,
            "PDO 0x%p, FDO 0x%p",
            WdfDeviceWdmGetPhysicalDevice(device),
            WdfDeviceWdmGetDeviceObject(device)
            );

Requisitos

Requisito Valor
Plataforma de Destino Universal
Versão mínima do KMDF 1.0
Cabeçalho wdfdevice.h (inclua Wdf.h)
Biblioteca Wdf01000.sys (consulte Controle de versão da biblioteca de estrutura.)
IRQL <=DISPATCH_LEVEL
Regras de conformidade da DDI DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf)

Confira também

WdfDeviceWdmGetPhysicalDevice