IWDFUsbInterface::SelectSetting-Methode (wudfusb.h)

[Warnung: UMDF 2 ist die neueste Version von UMDF und ersetzt UMDF 1. Alle neuen UMDF-Treiber sollten mit UMDF 2 geschrieben werden. UMDF 1 werden keine neuen Features hinzugefügt, und die Unterstützung für UMDF 1 für neuere Versionen von Windows 10 ist eingeschränkt. Universelle Windows-Treiber müssen UMDF 2 verwenden. Weitere Informationen finden Sie unter Erste Schritte mit UMDF.]

Die SelectSetting-Methode wählt die angegebene alternative Einstellung für eine USB-Schnittstelle aus.

Syntax

HRESULT SelectSetting(
  [in] UCHAR SettingNumber
);

Parameter

[in] SettingNumber

Die Einstellung, die auf der USB-Schnittstelle ausgewählt werden soll.

Rückgabewert

SelectSetting gibt einen der folgenden Werte zurück:

Rückgabecode	Beschreibung
S_OK	SelectSetting hat die Einstellung erfolgreich ausgewählt, die im Parameter SettingNumber angegeben wurde.
E_OUTOFMEMORY	Bei SelectSetting ist ein Zuordnungsfehler aufgetreten.
Ein Fehlercode, der in Winerror.h definiert ist	Dieser Wert entspricht dem Fehlercode, den die WinUsb-API zurückgegeben hat.

Hinweise

Das Framework wählt automatisch Die Konfiguration 0, die Schnittstelle 0 und die alternative Einstellung Null aus. Um die alternative Einstellung zu ändern, kann der Treiber SelectSetting aufrufen.

Weitere Informationen zu USB-Konfigurationsdeskriptoren

Beispiele

hr = pIWDFUsbInterface->SelectSetting(SettingNumber);

Anforderungen

Anforderung	Wert
Ende des Supports	In UMDF 2.0 und höher nicht verfügbar.
Zielplattform	Desktop
UMDF-Mindestversion	1.5
Kopfzeile	wudfusb.h (einschließlich Wudfusb.h)
DLL	WUDFx.dll

Weitere Informationen

IWDFUsbInterface