您现在的位置是:主页 > HID规范 >

USB复合HID设备报告描述符的区分

发布时间:2022-12-06 05:02:29所属栏目:HID规范 已帮助编辑作者:【USB接口百科】

在USB规范中,设备的功能是通过接口来承载的,在USB规格书中就是接口描述符。对于一般的设备,一般一个接口就是一个功能,这个功能可以是鼠标,键盘或其它设备类型。

当然这个只是对USB简易设备而言的,对于一些USB复杂设备如UVC摄像头,UAC音频等是多接口相互配合来实现其功能的,为了整合这么多接口使用接口关联描述符来整合。

现在我们言归正转。对于HID设备,其接口描述符下有一个HID描述符,HID描述符中含有其报告描述符的相关信息,如报告描述符的类型和长度。

但是这里有一个问题,假如我有一个USB设备,其是一个多功能设备,含有2个接口,其一个接口编号为0,一个编号为1,且2个接口都是HID设备类型,其对应的HID描述符中对应的报告描述符的类型和长度也一样。那么在枚举过程中,是怎么区分到底到获的是那个报告描述符的呢?

这其实是通过参数wIndex(即LanguageId)来实现区分的,在Hid_GetDescriptor时,传递的内容为该HID接口对应的接口ID.

20210518224415697153

通过统读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

     以上就是USB接口百科为您提供USB复合HID设备报告描述符的区分的解读,本文章链接: http://www.usb-hub.cn/hidgf/42321.html 欢迎分享转载,更多婚礼相关资讯请前往HID规范

上一篇:HID描述符

下一篇:HID 设备描述符关系