Función WdfFdoInitWdmGetPhysicalDevice (wdffdo.h)

[Solo se aplica a KMDF]

El método WdfFdoInitWdmGetPhysicalDevice recupera el objeto de dispositivo físico (PDO) de un dispositivo físico de un dispositivo.

Sintaxis

PDEVICE_OBJECT WdfFdoInitWdmGetPhysicalDevice(
  [in] PWDFDEVICE_INIT DeviceInit
);

Parámetros

[in] DeviceInit

Puntero a una estructura WDFDEVICE_INIT que el controlador obtuvo de su EvtDriverDeviceAdd función de devolución de llamada.

Valor devuelto

Si la operación se realiza correctamente, el método devuelve un puntero a una estructura de DEVICE_OBJECT. De lo contrario, el método devuelve NULL.

Observaciones

El controlador debe llamar a WdfFdoInitWdmGetPhysicalDevice antes de llamar a WdfDeviceCreate. Para obtener más información sobre cómo llamar a WdfDeviceCreate, vea Creating a Framework Device Object.

Para obtener más información sobre el método WdfFdoInitWdmGetPhysicalDevice, vea Creating Device Objects in a Function Driver.

Ejemplos

En el ejemplo de código siguiente se obtiene un puntero a una estructura de DEVICE_OBJECT que representa el PDO de WDM de un dispositivo.

PDEVICE_OBJECT device;

device = WdfFdoInitWdmGetPhysicalDevice(DeviceInit);

Requisitos

Requisito	Valor
de la plataforma de destino de	Universal
versión mínima de KMDF	1.0
encabezado	wdffdo.h (incluya Wdf.h)
Biblioteca	Wdf01000.sys (consulte Control de versiones de la biblioteca de marcos).
irQL	<= DISPATCH_LEVEL
reglas de cumplimiento de DDI	DeviceInitAPI(kmdf), DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf)