IOCTL_HID_READ_REPORT IOCTL (hidport.h)

Artículo
02/07/2025

El IOCTL_HID_READ_REPORT solicitud transfiere un informe de entrada de un dispositivo HIDClass al búfer del controlador de clase HID.

Para obtener información general sobre los dispositivos HIDClass, consulte colecciones HID.

Código principal

IRP_MJ_DEVICE_CONTROL

Búfer de entrada

Parameters.DeviceIoControl.OutputBufferLength contiene el tamaño del búfer proporcionado en Irp->UserBuffer.

Longitud del búfer de entrada

Tamaño de outputBufferLength

Búfer de salida

Minidriver HID rellena el búfer residente del sistema al que apunta Irp->UserBuffer con los datos del informe recuperados del dispositivo.

Longitud del búfer de salida

Tamaño del userBuffer de.

Bloque de estado

Minidriveres HID que llevan a cabo la E/S en el dispositivo establecen los siguientes campos de Irp->IoStatus:

de información se establece en el número de bytes transferidos desde el dispositivo.
Estado se establece en STATUS_SUCCESS si la transferencia se completó sin error. De lo contrario, se establece en un código de error NTSTATUS adecuado.

Los minidriveres HID que llaman a otros controladores con este IRP para llevar a cabo la E/S en su dispositivo deben asegurarse de que el campo Información del bloque de estado sea correcto y no cambie el contenido del campo Estado de.

Observaciones

IOCTL_HID_READ_REPORT normalmente se usa para completar continuamente los informes de entrada enviados por el dispositivo. El controlador de clase HID (HIDCLASS) envía este IOCTL de manera ping-pong. En otras palabras, tan pronto como se complete una solicitud (completada), se puede enviar otra al dispositivo, lo que permite la generación continua de informes de datos. Se trata de un mecanismo "asincrónico", por lo que, por ejemplo, el dispositivo puede usarlo para enviar datos al host, con respecto a los cambios en estado a medida que se producen esos cambios.