Función WdfIoTargetGetDevice (wdfiotarget.h)
[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) |