Função WdfDeviceWdmGetPhysicalDevice (wdfdevice.h)

  • Artigo

[Aplica-se somente ao KMDF]

O método WdfDeviceWdmGetPhysicalDevice recupera o PDO WDM do dispositivo físico da pilha do dispositivo.

Sintaxe

PDEVICE_OBJECT WdfDeviceWdmGetPhysicalDevice(
  [in] WDFDEVICE Device
);

Parâmetros

[in] Device

Um identificador para um objeto de dispositivo de estrutura.

Retornar valor

WdfDeviceWdmGetPhysicalDevice retorna um ponteiro para uma estrutura DEVICE_OBJECT .

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

WdfDeviceWdmGetPhysicalDevice retornará NULL se o chamador fornecer um objeto de dispositivo de controle.

Comentários

O ponteiro que o método WdfDeviceWdmGetPhysicalDevice 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

Para obter um exemplo de código que usa WdfDeviceWdmGetPhysicalDevice, consulte WdfDeviceWdmGetAttachedDevice.

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)