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
);

[in] DeviceInit

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

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.

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.

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

PDEVICE_OBJECT device;

device = WdfFdoInitWdmGetPhysicalDevice(DeviceInit);

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