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失败。