Share via

Función UdecxWdfDeviceTryHandleUserIoctl (udecxwdfdevice.h)

  • Artículo

Intenta controlar una solicitud IOCTL enviada por un software en modo de usuario.

Sintaxis

BOOLEAN UdecxWdfDeviceTryHandleUserIoctl(
       WDFDEVICE  UdecxWdfDevice,
  [in] WDFREQUEST Request
);

Parámetros

UdecxWdfDevice

Identificador de un objeto de dispositivo de marco que representa el controlador. El controlador cliente inicializó este objeto en la llamada anterior a UdecxWdfDeviceAddUsbDeviceEmulation.

[in] Request

Identificador de un objeto de solicitud de marco que representa la solicitud IOCTL.

Valor devuelto

TRUE indica que la extensión de clase de emulación de dispositivo USB (UdeCx) ha reconocido y completado la solicitud (con éxito o error). En este caso, el controlador cliente no debe completar la solicitud. FALSE en caso contrario; el controlador debe completar la solicitud.

Comentarios

El controlador cliente UDE se presenta al software en modo de usuario como controlador de controlador de host. El controlador de cliente registra y expone el GUID de la interfaz de dispositivo GUID_DEVINTERFACE_USB_HOST_CONTROLLER. El software en modo de usuario puede abrir un identificador para el dispositivo especificando ese GUID. Mediante ese identificador, el software puede enviar solicitudes IOCTL.

Nota Tenga en cuenta que los códigos IOCTL de otra interfaz pueden superponerse con la interfaz del controlador de host USB. Si dicha E/S alcanza esta función, el IOCTL no se controlará correctamente.
 
El controlador cliente no necesita procesar el IOCTL recibido. Puede enviar la solicitud a la extensión de clase llamando a UdecxWdfDeviceTryHandleUserIoctl. Si la extensión de clase reconoce la solicitud como una solicitud estándar, la completa. De lo contrario, se produce un error en la llamada y se espera que el controlador de cliente complete la solicitud. Para obtener una lista de ioCTLs que se deben controlar, consulte IOCTLs USB para aplicaciones y servicios.

Requisitos

Requisito Value
Cliente mínimo compatible Windows 10
Servidor mínimo compatible Windows Server 2016
Plataforma de destino Windows
Versión mínima de KMDF 1.15
Encabezado udecxwdfdevice.h (incluya Udecx.h)
Library Udecxstub.lib
IRQL PASSIVE_LEVEL

Consulte también

Arquitectura: emulación de dispositivos USB (UDE)

Escritura de un controlador de cliente UDE