Função WdfFdoInitWdmGetPhysicalDevice (wdffdo.h)

[Aplica-se somente ao KMDF]

O método WdfFdoInitWdmGetPhysicalDevice recupera o PDO (objeto de dispositivo físico) WDM de um dispositivo.

Sintaxe

PDEVICE_OBJECT WdfFdoInitWdmGetPhysicalDevice(
  [in] PWDFDEVICE_INIT DeviceInit
);

Parâmetros

[in] DeviceInit

Um ponteiro para uma estrutura WDFDEVICE_INIT que o driver obteve de sua função de retorno de chamada EvtDriverDeviceAdd.

Valor de retorno

Se a operação for bem-sucedida, o método retornará um ponteiro para uma estrutura DEVICE_OBJECT. Caso contrário, o método retornará NULL.

Observações

O driver deve chamar WdfFdoInitWdmGetPhysicalDevice antes de chamar WdfDeviceCreate. Para obter mais informações sobre como chamar WdfDeviceCreate, consulte Criando um objeto de dispositivo framework.

Para obter mais informações sobre o método WdfFdoInitWdmGetPhysicalDevice, consulte Criando objetos de dispositivo em um driver de função.

Exemplos

O exemplo de código a seguir obtém um ponteiro para uma estrutura de DEVICE_OBJECT que representa o PDO do WDM de um dispositivo.

PDEVICE_OBJECT device;

device = WdfFdoInitWdmGetPhysicalDevice(DeviceInit);

Requisitos

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