WinUsb_QueryInterfaceSettings 函数 (winusb.h)

项目
08/27/2023

WinUsb_QueryInterfaceSettings 函数检索特定接口句柄的指定备用接口设置的接口描述符。

语法

BOOL WinUsb_QueryInterfaceSettings(
  [in]  WINUSB_INTERFACE_HANDLE   InterfaceHandle,
  [in]  UCHAR                     AlternateInterfaceNumber,
  [out] PUSB_INTERFACE_DESCRIPTOR UsbAltInterfaceDescriptor
);

参数

[in] InterfaceHandle

所选配置中接口的不透明句柄。

若要检索第一个接口的设置，请使用 WinUsb_Initialize返回的句柄。对于所有其他接口，请使用目标接口的句柄， WinUsb_GetAssociatedInterface检索。

[in] AlternateInterfaceNumber

一个值，该值指示要返回哪些备用设置。值为 0 表示第一个备用设置，值 1 表示第二个备用设置，依此。

[out] UsbAltInterfaceDescriptor

指向调用方分配的USB_INTERFACE_DESCRIPTOR 结构的指针，该结构包含有关 AlternateSettingNumber 指定的接口的信息。

返回值

如果操作成功，WinUsb_QueryInterfaceSettings返回 TRUE。否则，它将返回 FALSE，调用方可以通过调用 GetLastError 检索记录的错误。

GetLastError 可以返回以下错误代码。

返回代码	说明
ERROR_INVALID_HANDLE	调用方在 InterfaceHandle 参数中传递 NULL。
ERROR_NO_MORE_ITEMS	找不到指定的备用接口。

注解

WinUsb_QueryInterfaceSettings 分析之前由 WinUsb_Initialize 检索的配置描述符。有关详细信息，请参阅 WinUsb_Initialize的“备注”部分。

WinUsb_QueryInterfaceSettings调用在接口数组中搜索由调用方在 AlternateSettingNumber 中传递的接口索引指定的备用接口。如果找到指定的接口，函数将填充调用方分配的USB_INTERFACE_DESCRIPTOR 结构。如果未找到指定的接口，则调用将失败并显示ERROR_NO_MORE_ITEMS代码。