WinUsb_QueryPipeEx函式 (winusb.h)

發行項
03/13/2024

WinUsb_QueryPipeEx函式會擷取有關指定端點和介面相關聯管道的擴充資訊。

語法

BOOL WinUsb_QueryPipeEx(
  [in]  WINUSB_INTERFACE_HANDLE     InterfaceHandle,
  [in]  UCHAR                       AlternateSettingNumber,
  [in]  UCHAR                       PipeIndex,
  [out] PWINUSB_PIPE_INFORMATION_EX PipeInformationEx
);

參數

[in] InterfaceHandle

介面的不透明句柄，其中包含與管道相關聯的端點。

若要查詢與第一個介面中端點相關聯的管道，請使用 WinUsb_Initialize傳回的句柄。對於所有其他介面，請使用目標介面的句柄，WinUsb_GetAssociatedInterface擷取。

[in] AlternateSettingNumber

值，指定要傳回資訊的替代介面。

[in] PipeIndex

值，指定要傳回相關信息的管道。這個值與端點描述元中的 bEndpointAddress 字段不同。 PipeIndex 值為 0 表示與介面相關聯的第一個端點、值為 1 表示第二個端點等等。 PipeIndex 必須小於介面描述元 之 bNumEndpoints 欄位中的值。

[out] PipeInformationEx

輸出上的指標，指向包含管道資訊的呼叫端配置 WINUSB_PIPE_INFORMATION_EX 結構。

傳回值

如果作業成功，WinUsb_QueryPipeEx傳回 TRUE。否則，此函式會傳回 FALSE，而且呼叫端可以呼叫 GetLastError 來擷取記錄的錯誤。

GetLastError 可以傳回下列錯誤碼。

傳回碼	Description
ERROR_INVALID_HANDLE	呼叫端在 InterfaceHandle 參數中傳遞 NULL。
ERROR_INVALID_PARAMETER	在 PipeInformation 參數中傳遞 NULL 的呼叫端;在 InterfaceHandle 中指定的句柄找不到介面描述元。
ERROR_NO_MORE_ITEMS	在 PipeIndex 參數中傳遞的值大於介面描述元的 bNumEndpoints 值;找不到指定介面的連接點描述元。