所需的 HID 描述符 (required-hid-descriptors)
本主题介绍 Windows 10 及更高版本操作系统中的 Windows 笔设备所需的 HID 描述符(和设备属性)。
所需 HID 描述符
下表显示了所需 USB HID 描述符。 有关详细信息,请参阅人机接口设备 (HID) 版本 1.11 的设备类定义中的 6.2.1 部分。
成员 | 大小(以字节为单位) | 说明 |
---|---|---|
bLength | 1 | 描述符的大小 |
bDescriptorType | 1 | 描述符的类型 |
bcdHID | 2 | HID 版本号 |
bCountryCode | 1 | 国家/地区代码 |
bNumDescriptors | 1 | 描述符的数目 |
bDescriptorType | 1 | 描述符类型 |
bDescriptorLength | 2 | 描述符的长度 |
所需的 I²C HID 描述符
下表显示了所需的 I²C HID 描述符。
成员 | 大小(以字节为单位) | 说明 |
---|---|---|
wHIDDescLength | 2 | 完整 HID 描述符的长度(以字节为单位)。 |
bcdVersion | 2 | 二进制编码的十进制 (BCD) 格式的版本号。 |
wReportDescLength | 2 | 报表描述符的长度(以字节为单位)。 |
wReportDescRegister | 2 | 包含报表描述符的注册索引。 |
wInputRegister | 2 | 用于读取输入报表的寄存器编号(以无符号字节)。 |
wMaxInputLength | 2 | 要从输入寄存器中读取的最大输入报表的长度。 |
wOutputRegister | 2 | 用于发送输出的寄存器编号(以无符号字节)。 |
wMaxOutputLength | 2 | 要发送的最大输出报表的长度。 |
wCommandRegister | 2 | 用于发送命令请求的寄存器编号(以无符号字节为单位)。 |
wDataRegister | 2 | 用于与命令请求交换数据的寄存器编号(以无符号字节为单位)。 |
wVendorID | 2 | USB-IF 分配的供应商 ID。 |
wDeviceID | 2 | 设备 ID。 |
wVersionID | 2 | 固件版本号。 |
所需的设备属性
必须在设备属性中提供以下 HID 属性。 这些设备属性的报告特定于总线。 有关所选总线,请参阅特定于 HID 的指南。
成员 | 说明 | USB | I²C |
---|---|---|---|
wVendorID | 供应商 ID | USB 设备描述符中的 idVendor | I²C HID 描述符中的 wVendorID(请参阅上表)。 |
wProduct | 产品 ID | USB 设备描述符中的 idProduct | I²C HID 描述符中的 wDeviceID(请参阅上表)。 |
wVersionID | 固件版本号 | USB 设备描述符中的 bcdDevice | wVersionID I²C HID 描述符(请参阅上表)。 |