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 设备驱动程序编程参考)