Función WdfDeviceWdmGetPhysicalDevice (wdfdevice.h)

[Solo se aplica a KMDF]

El método WdfDeviceWdmGetPhysicalDevice recupera el PDO de WDM del dispositivo físico de la pila de dispositivos.

Sintaxis

PDEVICE_OBJECT WdfDeviceWdmGetPhysicalDevice(
  [in] WDFDEVICE Device
);

Parámetros

[in] Device

Identificador de un objeto de dispositivo de marco.

Valor devuelto

WdfDeviceWdmGetPhysicalDevice devuelve un puntero a una estructura DEVICE_OBJECT .

Se produce una comprobación de errores si el controlador proporciona un identificador de objeto no válido.

WdfDeviceWdmGetPhysicalDevice devuelve NULL si el autor de la llamada proporciona un objeto de dispositivo de control.

Comentarios

El puntero que devuelve el método WdfDeviceWdmGetPhysicalDevice es válido hasta que se elimina el objeto de dispositivo de marco. Si el controlador proporciona una función EvtCleanupCallback para el objeto de dispositivo de marco, el puntero es válido hasta que la función de devolución de llamada devuelve.

Ejemplos

Para obtener un ejemplo de código que usa WdfDeviceWdmGetPhysicalDevice, vea WdfDeviceWdmGetAttachedDevice.

Requisitos

Requisito	Value
Plataforma de destino	Universal
Versión mínima de KMDF	1.0
Encabezado	wdfdevice.h (incluya Wdf.h)
Library	Wdf01000.sys (consulte Control de versiones de la biblioteca de marcos).
IRQL	<=DISPATCH_LEVEL
Reglas de cumplimiento de DDI	DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf)