IOCTL_HID_READ_REPORT IOCTL （hidport.h）

项目
02/07/2025

IOCTL_HID_READ_REPORT请求将输入报告从 HIDClass 设备传输到 HID 类驱动程序的缓冲区。

有关 HIDClass 设备的常规信息，请参阅 HID 集合。

主要代码

IRP_MJ_DEVICE_CONTROL

输入缓冲区

Parameters.DeviceIoControl.OutputBufferLength 包含 Irp->UserBuffer中提供的缓冲区的大小。

输入缓冲区长度

OutputBufferLength 的大小

输出缓冲区

HID 微型驱动程序使用从设备检索的报表数据填充由 Irp->UserBuffer 指向的系统驻留缓冲区。

输出缓冲区长度

UserBuffer的大小。

状态块

对设备执行 I/O 的 HID 微型驱动程序设置以下 Irp->IoStatus字段：

信息设置为从设备传输的字节数。
如果传输已完成且未出错，状态设置为STATUS_SUCCESS。否则，它设置为适当的 NTSTATUS 错误代码。

使用此 IRP 调用其他驱动程序的 HID 微型驱动程序应确保状态块的信息字段正确，并且不会更改状态字段的内容。

言论

IOCTL_HID_READ_REPORT通常用于持续完成设备发送的输入报告。此 IOCTL 由 HID 类驱动程序（HIDCLASS）以乒乓球方式发送。换句话说，一旦满足请求（已完成），就可以将另一个请求发送到设备，从而持续报告数据。这是一种“异步”机制，例如，设备可以使用它将数据发送到主机，这些更改发生时的状态更改。