Compartilhar via


função WinUsb_SetCurrentAlternateSetting (winusb.h)

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.

Código de retorno Descrição
ERROR_INVALID_HANDLE
O chamador passou NULL no parâmetro InterfaceHandle .

Comentários

WinUsb_SetCurrentAlternateSetting falha se as solicitações de E/S pendentes estiverem presentes na interface.

Requisitos

   
Plataforma de Destino Universal
Cabeçalho winusb.h (inclua Winusb.h)
Biblioteca Winusb.lib
DLL Winusb.dll

Confira também

USB_INTERFACE_DESCRIPTOR

WinUSB

Funções do WinUSB

WinUsb_Initialize

WinUsb_QueryInterfaceSettings