Compartir a través de

Función WdfFdoInitWdmGetPhysicalDevice (wdffdo.h)

  • Artículo

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