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)