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は失敗します。

要件

   
対象プラットフォーム ユニバーサル
Header winusb.h (Winusb.h を含む)
Library Winusb.lib
[DLL] Winusb.dll

関連項目

USB_INTERFACE_DESCRIPTOR

WinUSB

WinUSB 関数

WinUsb_Initialize

WinUsb_QueryInterfaceSettings