Compartir a través de

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) reconoció y completó 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.

Observaciones

El controlador cliente UDE se presenta al software en modo de usuario como controlador de controlador de host. El controlador 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 esta 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 Valor
cliente mínimo admitido Windows 10
servidor mínimo admitido Windows Server 2016
de la plataforma de destino de Windows
versión mínima de KMDF 1.15
encabezado de udecxwdfdevice.h (incluya Udecx.h)
biblioteca de Udecxstub.lib
irQL PASSIVE_LEVEL

Consulte también

Arquitectura de : de emulación de dispositivos USB (UDE)

Escribir un controlador de cliente UDE