Compartir a través de


Función WdfIoTargetGetDevice (wdfiotarget.h)

[Se aplica a KMDF y UMDF]

El método WdfIoTargetGetDevice devuelve un identificador al objeto de dispositivo de 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 de 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.

Observaciones

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 Valor
de la plataforma de destino de Universal
versión mínima de KMDF 1.0
versión mínima de UMDF 2.0
encabezado wdfiotarget.h (incluya Wdf.h)
Biblioteca 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