Función WdfIoTargetGetDevice (wdfiotarget.h)

  • Artículo

[Se aplica a KMDF y UMDF]

El método WdfIoTargetGetDevice devuelve un identificador al objeto de dispositivo del marco que es el elemento primario del destino de E/S local o remoto especificado.

Sintaxis

WDFDEVICE WdfIoTargetGetDevice(
  [in] WDFIOTARGET IoTarget
);

Parámetros

[in] IoTarget

Identificador de un objeto de destino de E/S. Este identificador se obtiene de WdfDeviceGetIoTarget, WdfIoTargetCreate o de un método que proporciona un destino de E/S especializado (como WdfUsbTargetDeviceGetIoTarget).

Valor devuelto

WdfIoTargetGetDevice devuelve un identificador a un objeto de dispositivo de marco.

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

Comentarios

Para obtener más información sobre WdfIoTargetGetDevice, 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 muestra cómo una función de devolución de llamada EvtIoTargetQueryRemove puede llamar a WdfIoTargetGetDevice.

NTSTATUS
MyEvtIoTargetQueryRemove(
    WDFIOTARGET IoTarget
)
{
WDFDEVICE device;
...
device = WdfIoTargetGetDevice(IoTarget);
...
}

Requisitos

Requisito Value
Plataforma de destino Universal
Versión mínima de KMDF 1.0
Versión mínima de UMDF 2.0
Encabezado wdfiotarget.h (incluya Wdf.h)
Library Wdf01000.sys (KMDF); WUDFx02000.dll (UMDF)
IRQL <=DISPATCH_LEVEL
Reglas de cumplimiento de DDI DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf)

Consulte también

WdfDeviceGetIoTarget

WdfIoTargetCreate

WdfUsbTargetDeviceGetIoTarget