USB复合HID设备报告描述符的区分
2021-05-18
10255
39
在USB规范中,设备的功能是通过接口来承载的,在USB规格书中就是接口描述符。对于一般的设备,一般一个接口就是一个功能,这个功能可以是鼠标,键盘或其它设备类型。
当然这个只是对USB简易设备而言的,对于一些USB复杂设备如UVC摄像头,UAC音频等是多接口相互配合来实现其功能的,为了整合这么多接口使用接口关联描述符来整合。
现在我们言归正转。对于HID设备,其接口描述符下有一个HID描述符,HID描述符中含有其报告描述符的相关信息,如报告描述符的类型和长度。
但是这里有一个问题,假如我有一个USB设备,其是一个多功能设备,含有2个接口,其一个接口编号为0,一个编号为1,且2个接口都是HID设备类型,其对应的HID描述符中对应的报告描述符的类型和长度也一样。那么在枚举过程中,是怎么区分到底到获的是那个报告描述符的呢?
这其实是通过参数wIndex(即LanguageId)来实现区分的,在Hid_GetDescriptor时,传递的内容为该HID接口对应的接口ID.
通过统读REACTOS源代码,其获取报告描述符是通过Hid_GetDescriptor函数来实现的。
其函数定义如下:
NTSTATUS
Hid_GetDescriptor(
IN PDEVICE_OBJECT DeviceObject,
IN USHORT UrbFunction,
IN USHORT UrbLength,
IN OUT PVOID *UrbBuffer,
IN OUT PULONG UrbBufferLength,
IN UCHAR DescriptorType,
IN UCHAR Index,
IN USHORT LanguageIndex)
其获取报告描述符的调用代码如下:
BufferLength = HidDeviceExtension->HidDescriptor->DescriptorList[0].wReportLength;
Status = Hid_GetDescriptor(DeviceObject,
URB_FUNCTION_GET_DESCRIPTOR_FROM_INTERFACE,
sizeof(struct _URB_CONTROL_DESCRIPTOR_REQUEST),
&Report,
&BufferLength,
HidDeviceExtension->HidDescriptor->DescriptorList[0].bReportType,
0,
HidDeviceExtension->InterfaceInfo->InterfaceNumber);
可以看到:
LanguageIndex = HidDeviceExtension->InterfaceInfo->InterfaceNumber
Index = 0
DescriptorType = HidDeviceExtension->HidDescriptor->DescriptorList[0].bReportType,
UrbBufferLength = &HidDeviceExtension->HidDescriptor->DescriptorList[0].wReportLength;
urb = &_URB_CONTROL_DESCRIPTOR_REQUEST
UrbFunction = URB_FUNCTION_GET_DESCRIPTOR_FROM_INTERFACE
本人手中有一个超级无比复杂的设备,其对应的抓包内容为:
16.0 CTL 81 06 00 22 02 00 f0 02 GET DESCRIPTOR 382us 30.1.0
53.0 CTL 81 06 00 22 05 00 cd 00 GET DESCRIPTOR 13us 41.1.0
64.0 CTL 81 06 00 22 06 00 7f 00 GET DESCRIPTOR 394us 63.1.0
HID人机交互QQ群:564808376
UAC音频QQ群:218581009
UVC相机QQ群:331552032
BOT&UASP大容量存储QQ群:258159197
STC-USB单片机QQ群:315457461
USB技术交流QQ群2:580684376
USB技术交流QQ群:952873936