Función WdfDeviceGetIoTarget (wdfdevice.h)
[Se aplica a KMDF y UMDF]
El método WdfDeviceGetIoTarget devuelve un identificador a una función o destino de E /S local del controlador de filtro para un dispositivo especificado.
Sintaxis
WDFIOTARGET WdfDeviceGetIoTarget(
[in] WDFDEVICE Device
);
Parámetros
[in] Device
Identificador de un objeto de dispositivo de marco.
Valor devuelto
Si la operación se realiza correctamente, WdfDeviceGetIoTarget devuelve un identificador a un objeto de destino de E/S de marco. Si el objeto de dispositivo de marco especificado representa un PDO, el método devuelve NULL.
Se produce una comprobación de errores si el controlador proporciona un identificador de objeto no válido.
Comentarios
Cuando un controlador UMDF envía una solicitud creada por el controlador a un destino de E/S local, la solicitud no tiene ningún objeto de archivo asociado. Algunos destinos inferiores, como un PDO sin formato enumerado por HIDClass, producen un error en las solicitudes que no tienen ningún objeto de archivo asociado. En esta situación, un controlador UMDF puede especificar WdfIoTargetOpenLocalTargetByFile para crear un destino de E/S que represente la pila inferior (al igual que un destino local) mediante un identificador de archivo. Como resultado, las solicitudes creadas por el controlador enviadas a este destino de E/S están asociadas al objeto de archivo correspondiente al identificador abierto.
Para ello, llame a la función WDF_IO_TARGET_OPEN_PARAMS_INIT_OPEN_BY_FILE antes de llamar a WdfIoTargetOpen.
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 identificador para el destino de E/S local de un dispositivo especificado.
WDFIOTARGET ioTargetHandle;
ioTargetHandle = WdfDeviceGetIoTarget(device);
Requisitos
| Requisito | Value |
|---|---|
| Plataforma de destino | Universal |
| Versión mínima de KMDF | 1.0 |
| Versión mínima de UMDF | 2.0 |
| Encabezado | wdfdevice.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) |