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 |
|---|---|
|
SelectSetting hat die Einstellung erfolgreich ausgewählt, die im Parameter SettingNumber angegeben wurde. |
|
Bei SelectSetting ist ein Zuordnungsfehler aufgetreten. |
|
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 |