Función WdfFdoInitWdmGetPhysicalDevice (wdffdo.h)

[Solo se aplica a KMDF]

El método WdfFdoInitWdmGetPhysicalDevice recupera el objeto de dispositivo físico WDM (PDO) 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 función de devolución de llamada EvtDriverDeviceAdd .

Valor devuelto

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

Comentarios

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	Value
Plataforma de destino	Universal
Versión mínima de KMDF	1.0
Encabezado	wdffdo.h (incluir Wdf.h)
Library	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)