IOCTL_HID_GET_INPUT_REPORT IOCTL (hidclass.h)

  • 项目

IOCTL_HID_GET_INPUT_REPORT请求从 顶级集合获取输入报表。

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

主要代码

IRP_MJ_DEVICE_CONTROL

输入缓冲区

成员 Parameters.DeviceIoControl.OutputBufferLength 指定请求者分配的输出缓冲区的大小（以字节为单位）。 HID 类驱动程序使用此缓冲区返回输入报告。

如果集合包含报表 ID，则请求者必须将输出缓冲区的第一个字节设置为非零报表 ID。 否则，请求者必须将输出缓冲区的第一个字节设置为零。

微型驱动程序处理

Irp->UserBuffer 指向 HID 类驱动程序用于输入以下成员 的HID_XFER_PACKET 结构：

输入缓冲区长度

缓冲区的大小（以字节为单位）。 缓冲区必须足够大，才能保存输入报表以及一个指定非零报表 ID 的附加字节。 如果未使用报表 ID，则 ID 值为零。

输出缓冲区

成员 Irp->MdlAddress 指向请求者分配的输出缓冲区，HID 类驱动程序使用该缓冲区返回输入报告。 缓冲区的第一个字节（请求者用来输入报表 ID 或零）保持不变。 输入报告在 处 ((PUCHAR)Irp->MdlAddress + 1)返回。

微型驱动程序处理

((PHID_XFER_PACKET)(Irp->UserBuffer))->reportBuffer 指向请求者分配的输出缓冲区，HID 微型驱动程序使用该缓冲区返回输入报告。

输出缓冲区长度

输出报表的大小。

状态块

HID 类驱动程序设置 的以下字段 Irp->IoStatus：

  • 信息 设置为零。
  • 如果传输未出错，则状态设置为STATUS_SUCCESS。 否则，它会设置为相应的 NTSTATUS 错误代码。

微型驱动程序处理

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

  • 信息 设置为从设备传输的字节数。
  • 如果传输未出错，则状态设置为STATUS_SUCCESS。 否则，它会设置为相应的 NTSTATUS 错误代码。

使用此 IOCTL 调用其他驱动程序以对其设备执行 I/O 的 HID 微型驱动程序应确保状态块 的“信息” 字段正确且不会更改 “状态” 字段的内容。

要求

要求 值
Header hidclass.h (包括 Hidclass.h)

另请参阅