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 は 、次のエラー コードを返すことができます。
| リターン コード | 説明 |
|---|---|
|
呼び出し元が InterfaceHandle パラメーターに NULL を渡しました。 |
解説
未処理の I/O 要求がインターフェイスに存在する場合、WinUsb_SetCurrentAlternateSettingは失敗します。
要件
| 対象プラットフォーム | ユニバーサル |
| Header | winusb.h (Winusb.h を含む) |
| Library | Winusb.lib |
| [DLL] | Winusb.dll |