функция 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

Значение, содержащееся в элементе bAlternateSettingструктуры USB_INTERFACE_DESCRIPTOR . Эта структура заполняется подпрограммой WinUsb_QueryInterfaceSettings .

Возвращаемое значение

WinUsb_SetCurrentAlternateSetting возвращает значение TRUE , если операция выполнена успешно. В противном случае эта функция возвращает значение FALSE, и вызывающий объект может получить зарегистрированную ошибку, вызвав Метод GetLastError.

GetLastError может вернуть следующий код ошибки.

Код возврата Описание
ERROR_INVALID_HANDLE
 Вызывающий объект передал значение NULL в параметре InterfaceHandle .

Комментарии

WinUsb_SetCurrentAlternateSetting , если в интерфейсе присутствуют невыполненные запросы ввода-вывода, WinUsb_SetCurrentAlternateSetting.

Требования

   
Целевая платформа Универсальное
Верхняя часть winusb.h (включая Winusb.h)
Библиотека Winusb.lib
DLL Winusb.dll

См. также раздел

USB_INTERFACE_DESCRIPTOR

WinUSB

Функции WinUSB

WinUsb_Initialize

WinUsb_QueryInterfaceSettings