Compartilhar via


Método IWDFUsbInterface::SelectSetting (wudfusb.h)

[Aviso: UMDF 2 é a versão mais recente do UMDF e substitui o UMDF 1. Todos os novos drivers UMDF devem ser gravados usando UMDF 2. Nenhum recurso novo está sendo adicionado ao UMDF 1 e há suporte limitado para UMDF 1 em versões mais recentes do Windows 10. Os drivers universais do Windows devem usar o UMDF 2. Para obter mais informações, consulte Introdução aoda UMDF .]

O método SelectSetting seleciona a configuração alternativa especificada em uma interface USB.

Sintaxe

HRESULT SelectSetting(
  [in] UCHAR SettingNumber
);

Parâmetros

[in] SettingNumber

A configuração a ser selecionada na interface USB.

Valor de retorno

SelectSetting retorna um dos seguintes valores:

Código de retorno Descrição
S_OK

SelectSetting selecionou com êxito a configuração especificada pelo parâmetro SettingNumber.

E_OUTOFMEMORY

SelectSetting encontrou uma falha de alocação.

Um código de erro definido em Winerror.h
Esse valor corresponde ao código de erro retornado pela API do WinUsb.

Observações

A estrutura seleciona automaticamente a configuração zero, sua interface zero e a configuração alternativa zero. Para alterar a configuração alternativa, o driver pode chamar SelectSetting.

Para obter mais informações descritores de configuração USB

Exemplos


hr = pIWDFUsbInterface->SelectSetting(SettingNumber);

Requisitos

Requisito Valor
fim do suporte Indisponível no UMDF 2.0 e posterior.
da Plataforma de Destino Área de trabalho
versão mínima do UMDF 1.5
cabeçalho wudfusb.h (inclua Wudfusb.h)
de DLL WUDFx.dll

Consulte também

IWDFUsbInterface