USBD_ParseConfigurationDescriptorEx 函数 (usbdlib.h)

  • 项目

USBD_ParseConfigurationDescriptorEx例程搜索给定的配置描述符，并返回指向与给定搜索条件匹配的接口的指针。

语法

PUSB_INTERFACE_DESCRIPTOR USBD_ParseConfigurationDescriptorEx(
  [in] PUSB_CONFIGURATION_DESCRIPTOR ConfigurationDescriptor,
  [in] PVOID                         StartPosition,
  [in] LONG                          InterfaceNumber,
  [in] LONG                          AlternateSetting,
  [in] LONG                          InterfaceClass,
  [in] LONG                          InterfaceSubClass,
  [in] LONG                          InterfaceProtocol
);

参数

[in] ConfigurationDescriptor

指向 USB 配置描述符的指针，该描述符包含要搜索的接口。

[in] StartPosition

指向配置描述符中的地址的指针，该地址在 ConfigurationDescriptor 中提供，以便从中开始搜索。 若要从配置描述符的开头进行搜索， 参数 ConfigurationDescriptor 和 StartPosition 必须是相同的地址。

[in] InterfaceNumber

指定要检索的接口的设备定义的索引。 如果不应为搜索条件，则应将其设置为 -1。

[in] AlternateSetting

指定要检索的接口的设备定义的备用设置索引。 如果调用方不希望备用设置值成为搜索条件，则应将此参数设置为 -1。

[in] InterfaceClass

指定要检索的接口的接口类的设备或 USB 定义的标识符。 如果调用方不希望接口类值成为搜索条件，则应将此参数设置为 -1。

[in] InterfaceSubClass

指定要检索的接口的接口子类的设备或 USB 定义的标识符。 如果调用方不希望接口子类值成为搜索条件，则应将此参数设置为 -1。

[in] InterfaceProtocol

指定要检索的接口的接口协议的设备或 USB 定义的标识符。 如果调用方不希望接口协议值成为搜索条件，则应将此参数设置为 -1。

返回值

USBD_ParseConfigurationDescriptorEx 返回指向与给定搜索条件匹配的第一个接口描述符的指针。 如果没有接口与搜索条件匹配，则返回 NULL。

注解

使用此例程在配置描述符中查找接口时，调用方可以指定多个搜索条件 (InterfaceNumber、AlternateSetting、InterfaceClass、InterfaceSubClass 和 InterfaceProtocol) 。 有关示例代码，请参阅 USBD_CreateConfigurationRequestEx。

当此例程分析查找与搜索条件匹配的接口描述符的配置描述符时，它将返回第一个匹配项，即终止搜索。 调用方应指定查找所需接口所需的任意数量的搜索条件。

要求

要求 值
目标平台 通用
标头 usbdlib.h (包括 Usbdlib.h)
Library Usbd.lib
IRQL < DISPATCH_LEVEL

另请参阅

USB device driver programming reference（USB 设备驱动程序编程参考）

USB_CONFIGURATION_DESCRIPTOR