Metodo IWDFUsbInterface::SelectSetting (wudfusb.h)

[Avviso: UMDF 2 è la versione più recente di UMDF e sostituisce UMDF 1. Tutti i nuovi driver UMDF devono essere scritti usando UMDF 2. Non vengono aggiunte nuove funzionalità a UMDF 1 ed è disponibile un supporto limitato per UMDF 1 nelle versioni più recenti di Windows 10. I driver di Windows universali devono usare UMDF 2. Per altre informazioni, vedi Introduzione a UMDF.]

Il metodo SelectSetting seleziona l'impostazione alternativa specificata in un'interfaccia USB.

Sintassi

HRESULT SelectSetting(
  [in] UCHAR SettingNumber
);

Parametri

[in] SettingNumber

Impostazione da selezionare nell'interfaccia USB.

Valore restituito

SelectSetting restituisce uno dei valori seguenti:

Codice restituito	Descrizione
S_OK	SelectSetting selezionato correttamente l'impostazione specificata dal parametro SettingNumber.
E_OUTOFMEMORY	SelectSetting rilevato un errore di allocazione.
Codice di errore definito in Winerror.h	Questo valore corrisponde al codice di errore restituito dall'API WinUsb.

Osservazioni

Il framework seleziona automaticamente la configurazione zero, l'interfaccia zero e l'impostazione alternativa zero. Per modificare l'impostazione alternativa, il driver può chiamare SelectSetting.

Per altre informazioni descrittori di configurazione USB

Esempi

hr = pIWDFUsbInterface->SelectSetting(SettingNumber);

Fabbisogno

Requisito	Valore
Fine del supporto	Non disponibile in UMDF 2.0 e versioni successive.
piattaforma di destinazione	Desktop
versione minima di UMDF	1.5
intestazione	wudfusb.h (include Wudfusb.h)
dll	WUDFx.dll

Vedere anche

IWDFUsbInterface