Função WdfDeviceWdmGetPhysicalDevice (wdfdevice.h)

[Aplica-se somente ao KMDF]

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

Sintaxe

PDEVICE_OBJECT WdfDeviceWdmGetPhysicalDevice(
  [in] WDFDEVICE Device
);

Parâmetros

[in] Device

Um identificador para um objeto de dispositivo de estrutura.

Valor de retorno

WdfDeviceWdmGetPhysicalDevice retorna um ponteiro para uma estrutura DEVICE_OBJECT.

Uma verificação de bug ocorre se o driver fornece um identificador de objeto inválido.

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

Observações

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