função WinUsb_QueryInterfaceSettings (winusb.h)

Artigo
03/04/2024

A função WinUsb_QueryInterfaceSettings recupera o descritor de interface para as configurações de interface alternativa especificadas para um identificador de interface específico.

Sintaxe

BOOL WinUsb_QueryInterfaceSettings(
  [in]  WINUSB_INTERFACE_HANDLE   InterfaceHandle,
  [in]  UCHAR                     AlternateInterfaceNumber,
  [out] PUSB_INTERFACE_DESCRIPTOR UsbAltInterfaceDescriptor
);

Parâmetros

[in] InterfaceHandle

Um identificador opaco para uma interface na configuração selecionada.

Para recuperar as configurações da primeira interface, use o identificador retornado por WinUsb_Initialize. Para todas as outras interfaces, use o identificador para a interface de destino, recuperada por WinUsb_GetAssociatedInterface.

[in] AlternateInterfaceNumber

Um valor que indica quais configurações alternativas devem ser retornadas. Um valor de 0 indica a primeira configuração alternativa, um valor de 1 indica a segunda configuração alternativa e assim por diante.

[out] UsbAltInterfaceDescriptor

Um ponteiro para uma estrutura de USB_INTERFACE_DESCRIPTOR alocada pelo chamador que contém informações sobre a interface especificada por AlternateSettingNumber .

Retornar valor

WinUsb_QueryInterfaceSettingsretornará TRUE se a operação for bem-sucedida. Caso contrário, ele 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 .
ERROR_NO_MORE_ITEMS	A interface alternativa especificada não foi encontrada.

Comentários

WinUsb_QueryInterfaceSettings analisa o descritor de configuração recuperado anteriormente por WinUsb_Initialize. Para obter mais informações, consulte a seção Comentários para WinUsb_Initialize.

A chamada WinUsb_QueryInterfaceSettings pesquisa a matriz de interface para a interface alternativa especificada pelo índice de interface passado pelo chamador no AlternateSettingNumber. Se a interface especificada for encontrada, a função preencherá a estrutura de USB_INTERFACE_DESCRIPTOR alocada pelo chamador. Se a interface especificada não for encontrada, a chamada falhará com o código ERROR_NO_MORE_ITEMS.