USB 设备描述符

  • 项目

设备描述符包含有关 USB 设备整体的信息。 本主题介绍 USB_DEVICE_DESCRIPTOR 结构，并包含有关客户端驱动程序如何发送 get-描述符请求以获取设备描述符的信息。

每个通用串行总线 (USB) 设备都必须能够提供包含设备相关信息的单个设备描述符。 USB_DEVICE_DESCRIPTOR 结构描述设备描述符。 Windows 使用该信息来派生各种信息集。 例如， idVendor 和 idProduct 字段分别指定供应商和产品标识符。 Windows 使用这些字段值来构造设备 的硬件 ID 。 若要查看特定设备的硬件 ID，请打开设备管理器并查看设备属性。 在“ 详细信息 ”选项卡中， “硬件 ID ”属性值指示 Windows 生成的硬件 ID (“USB\XXX”) 。 bcdUSB 字段指示设备符合的 USB 规范的版本。 例如，0x0200指示设备按照 USB 2.0 规范设计。 bcdDevice 值指示设备定义的修订号。 USB 驱动程序堆栈使用 bcdDevice 以及 idVendor 和 idProduct 为设备生成硬件和兼容 ID。 可以在 设备管理器 中查看这些标识符。 设备描述符还指示设备支持的配置总数。

当设备以高速容量连接到主计算机时，设备在其设备描述符中报告的信息可能与以全速容量连接时不同。 设备不得在连接的生存期内（包括电源状态更改期间）更改设备描述符中包含的信息。

主机通过控件传输获取设备描述符。 在传输中，请求类型为 GET DESCRIPTOR，接收方为设备。 客户端驱动程序可以通过以下两种方式之一启动该传输：使用框架 USB 目标设备对象或通过发送包含请求信息的 URB。

获取设备描述符

Windows 驱动程序框架 (WDF) 客户端驱动程序只能在创建框架 USB 目标设备对象后获取设备描述符。

KMDF 驱动程序必须通过调用 WdfUsbTargetDeviceCreate 获取 USB 目标设备对象的 WDFUSBDEVICE 句柄。 通常，客户端驱动程序在驱动程序的 EvtDevicePrepareHardware 回调实现中调用 WdfUsbTargetDeviceCreate。 之后，客户端驱动程序必须调用 WdfUsbTargetDeviceGetDeviceDescriptor 方法。 调用完成后，设备描述符在调用方分配 的USB_DEVICE_DESCRIPTOR 结构中接收。

UMDF 驱动程序必须查询 IWDFUsbTargetDevice 指针的框架设备对象，然后调用 IWDFUsbTargetDevice：：RetrieveDescriptor 方法，并将 USB_DEVICE_DESCRIPTOR_TYPE 指定为描述符类型。

主机还可以通过发送 URB 来获取设备描述符。 此方法仅适用于内核模式驱动程序。 但是，除非驱动程序基于 Windows 驱动程序模型 (WDM) ，否则客户端驱动程序应永远不必为此类请求发送 URB。 此类驱动程序必须分配 URB 结构，然后调用 UsbBuildGetDescriptorRequest 宏以指定请求的 URB 格式。 然后，驱动程序可以通过将 URB 提交到 USB 驱动程序堆栈来发送请求。 有关详细信息，请参阅 如何提交 URB。

此代码示例演示 UsbBuildGetDescriptorRequest 调用，该调用使用相应的 URB 设置 pURB 指向的缓冲区的格式：

UsbBuildGetDescriptorRequest(
    pURB,                                                 // Points to the URB to be formatted
    sizeof(struct _URB_CONTROL_DESCRIPTOR_REQUEST),
    USB_DEVICE_DESCRIPTOR_TYPE,
    0,                                                    // Not used for device descriptors
    0,                                                    // Not used for device descriptors
    pDescriptor,                                          // Points to a USB_DEVICE_DESCRIPTOR structure
    NULL,
    sizeof(USB_DEVICE_DESCRIPTOR),
    NULL
);

示例设备描述符

此示例演示 USB 网络摄像头设备的设备描述符， (请参阅使用 USBView 应用程序获取的 USB 设备布局) ：

Device Descriptor:
bcdUSB:             0x0200
bDeviceClass:         0xEF
bDeviceSubClass:      0x02
bDeviceProtocol:      0x01
bMaxPacketSize0:      0x40 (64)
idVendor:           0x045E (Microsoft Corporation)
idProduct:          0x0728
bcdDevice:          0x0100
iManufacturer:        0x01
0x0409: "Microsoft"
iProduct:             0x02
0x0409: "Microsoft LifeCam VX-5000"
0x0409: "Microsoft LifeCam VX-5000"
iSerialNumber:        0x00
bNumConfigurations:   0x01

在前面的示例中，你将看到设备已根据 USB 规范版本 2.0 进行了开发。 请注意 bDeviceClass、 bDeviceSubClass 和 bDeviceProtocol 值。 这些值指示设备包含一个或多个 USB 接口关联描述符，可用于对每个函数的多个接口进行分组。 有关详细信息，请参阅 USB 接口关联描述符。

接下来，请参阅 bMaxPacketSize0 的值。 此值指示默认终结点的最大数据包大小。 此示例设备可以通过其默认终结点传输最多 64 字节的数据。

通常，若要配置设备，客户端驱动程序会在获取设备描述符后获取有关设备中支持的配置的信息。 若要确定设备支持的配置数，请检查返回结构的 bNumConfigurations 成员。 此设备支持一种配置。 若要获取有关 USB 配置的信息，驱动程序必须获取 USB 配置描述符。