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) |
库 | Usbd.lib |
IRQL | < DISPATCH_LEVEL |