WinUsb_SetCurrentAlternateSetting函式 (winusb.h)

WinUsb_SetCurrentAlternateSetting函式會設定介面的替代設定。

語法

BOOL WinUsb_SetCurrentAlternateSetting(
  [in] WINUSB_INTERFACE_HANDLE InterfaceHandle,
  [in] UCHAR                   SettingNumber
);

[in] InterfaceHandle

介面的不透明控制碼，它會定義要設定的替代設定。

若要在裝置上的第一個介面中設定替代設定，請使用 WinUsb_Initialize傳回的介面控制碼。對於所有其他介面，請使用目標介面的控制碼，WinUsb_GetAssociatedInterface擷取。

[in] SettingNumber

包含在USB_INTERFACE_DESCRIPTOR結構的bAlternateSetting成員中的值。這個結構會由 WinUsb_QueryInterfaceSettings 常式填入。

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

GetLastError 可以傳回下列錯誤碼。

傳回碼	描述
ERROR_INVALID_HANDLE	呼叫端在InterfaceHandle參數中傳遞Null。

如果介面上存在未完成的 I/O 要求，WinUsb_SetCurrentAlternateSetting就會失敗。