função WinUsb_SetCurrentAlternateSetting (winusb.h)

Artigo
08/27/2023

A função WinUsb_SetCurrentAlternateSetting define a configuração alternativa de uma interface.

Sintaxe

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

Parâmetros

[in] InterfaceHandle

Um identificador opaco para uma interface, que define a configuração alternativa a ser definida.

Para definir uma configuração alternativa na primeira interface no dispositivo, use o identificador de interface retornado por WinUsb_Initialize. Para todas as outras interfaces, use o identificador para a interface de destino, recuperada por WinUsb_GetAssociatedInterface.

[in] SettingNumber

O valor contido no membro bAlternateSetting da estrutura USB_INTERFACE_DESCRIPTOR . Essa estrutura é preenchida pela rotina WinUsb_QueryInterfaceSettings .

Valor retornado

WinUsb_SetCurrentAlternateSettingretornará TRUE se a operação for bem-sucedida. Caso contrário, essa função retornará FALSE e o chamador poderá recuperar o erro registrado chamando GetLastError.

GetLastError pode retornar o código de erro a seguir.