Função WdfDeviceWdmGetPhysicalDevice (wdfdevice.h)

Artigo
03/22/2025

[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

Requisito	Valor
da Plataforma de Destino	Universal
versão mínima do KMDF	1.0
cabeçalho	wdfdevice.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), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf)

Partilhar via