设备、配置和接口描述符可能包含对字符串描述符的引用。 本主题介绍如何从设备获取特定字符串描述符。
字符串描述符由其基于一个的索引号引用。 字符串描述符包含一个或多个 Unicode 字符串;每个字符串都是将其他字符串翻译成另一种语言。
Client drivers use UsbBuildGetDescriptorRequest, with DescriptorType = USB_STRING_DESCRIPTOR_TYPE, to build the request to obtain a string descriptor. The Index parameter specifies the index number, and the LanguageID parameter specifies the language ID (the same values are used as in Microsoft Win32 LANGID values). 驱动程序可以请求特殊索引号零，以确定设备支持的语言 ID。 对于此特殊值，设备返回语言 ID 数组，而不是 Unicode 字符串。
由于字符串描述符由可变长度数据组成，因此驱动程序必须在两个步骤中获取它。 首先，驱动程序必须发出请求，传递足够大的数据缓冲区来保存字符串描述符（USB_STRING_DESCRIPTOR结构）的标头。 The bLength member of USB_STRING_DESCRIPTOR specifies the size in bytes of the entire descriptor. The driver then makes the same request with a data buffer of size bLength.
The following code demonstrates how to request the i-th string descriptor, with language ID langID:
USB_STRING_DESCRIPTOR USD, *pFullUSD;
UsbBuildGetDescriptorRequest(
pURB, // points to the URB to be filled in
sizeof(struct _URB_CONTROL_DESCRIPTOR_REQUEST),
USB_STRING_DESCRIPTOR_TYPE,
i, // index of string descriptor
langID, // language ID of string.
&USD, // points to a USB_STRING_DESCRIPTOR.
NULL,
sizeof(USB_STRING_DESCRIPTOR),
NULL
);
pFullUSD = ExAllocatePool(NonPagedPool, USD.bLength);
UsbBuildGetDescriptorRequest(
pURB, // points to the URB to be filled in
sizeof(struct _URB_CONTROL_DESCRIPTOR_REQUEST),
USB_STRING_DESCRIPTOR_TYPE,
i, // index of string descriptor
langID, // language ID of string
pFullUSD,
NULL,
USD.bLength,
NULL
);