Función WdfIoTargetWdmGetTargetPhysicalDevice (wdfiotarget.h)

[Solo se aplica a KMDF]

El método WdfIoTargetWdmGetTargetPhysicalDevice devuelve un puntero al objeto de dispositivo físico del modelo de controlador de Windows (WDM) que representa el dispositivo del destino de E/S remoto.

Sintaxis

PDEVICE_OBJECT WdfIoTargetWdmGetTargetPhysicalDevice(
  [in] WDFIOTARGET IoTarget
);

Parámetros

[in] IoTarget

Identificador de un objeto de destino de E/S remoto. Este identificador se obtuvo de una llamada anterior a WdfIoTargetCreate.

Valor devuelto

Si el destino de E/S representa un dispositivo PnP, WdfIoTargetWdmGetTargetPhysicalDevice devuelve un puntero a una estructura de DEVICE_OBJECT que representa el PDO de un destino de E/S remoto. De lo contrario, el método devuelve NULL.

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

Comentarios

El puntero que devuelve el método WdfIoTargetWdmGetTargetPhysicalDevice es válido hasta que el controlador llama a WdfIoTargetClose o WdfIoTargetCloseForQueryRemove o hasta que se elimine el objeto de destino de E/S remoto. Si el controlador proporciona una función EvtCleanupCallback para el objeto de destino de E/S remoto y si el objeto se elimina antes de cerrar el destino de E/S remota, el puntero es válido hasta que la función EvtCleanupCallback devuelve.

Si el controlador intenta acceder al objeto de dispositivo WDM después de quitarlo, el controlador puede hacer que el sistema se bloquee. El ejemplo toastmon muestra cómo el controlador puede proporcionar una función de devolución de llamada EvtIoTargetQueryRemove para que se notifique si se quita el destino de E/S.

Para obtener más información sobre WdfIoTargetWdmGetTargetPhysicalDevice, vea Obtener información sobre un destino de E/S general.

Para obtener más información sobre los destinos de E/S, consulte Uso de destinos de E/S.

Ejemplos

En el ejemplo de código siguiente se obtiene un puntero a una estructura de DEVICE_OBJECT que representa el PDO del dispositivo del destino de E/S remoto.

PDEVICE_OBJECT  pTargetDO;

pTargetDO = WdfIoTargetWdmGetTargetPhysicalDevice(IoTarget);

Requisitos

Requisito	Value
Plataforma de destino	Universal
Versión mínima de KMDF	1.0
Encabezado	wdfiotarget.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)

Consulte también

DEVICE_OBJECT

WdfIoTargetCreate