WinUsb_QueryInterfaceSettings函式 (winusb.h)

發行項
03/09/2024

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 可以傳回下列錯誤碼。

傳回碼	Description
ERROR_INVALID_HANDLE	呼叫端在 InterfaceHandle 參數中傳遞 NULL。
ERROR_NO_MORE_ITEMS	找不到指定的替代介面。

備註

WinUsb_QueryInterfaceSettings 剖析先前由 WinUsb_Initialize 擷取的組態描述元。 For more information, see the Remarks section for WinUsb_Initialize.

WinUsb_QueryInterfaceSettings呼叫會搜尋介面數位，尋找 AlternateSettingNumber 中呼叫埠傳遞之介面索引所指定的替代介面。如果找到指定的介面，函式會填入呼叫端配置的 USB_INTERFACE_DESCRIPTOR 結構。如果找不到指定的介面，則呼叫會因為ERROR_NO_MORE_ITEMS程式代碼而失敗。