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. Es werden keine neuen Features zu UMDF 1 hinzugefügt, und es gibt eingeschränkte Unterstützung für UMDF 1 für neuere Versionen von Windows 10. 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 auf einer 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 die Einstellung erfolgreich ausgewählt, die der SettingNumber Parameter angegeben hat. |
|
SelectSetting ein Zuordnungsfehler aufgetreten ist. |
|
Dieser Wert entspricht dem Fehlercode, den die WinUsb-API zurückgegeben hat. |
Bemerkungen
Das Framework wählt automatisch die Konfiguration Null, die Schnittstelle Null und die alternative Einstellung Null aus. Um die alternative Einstellung zu ändern, kann der Treiber SelectSetting-aufrufen.
Weitere Informationen 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 |
| Mindest-UMDF-Version | 1.5 |
| Header- | wudfusb.h (include Wudfusb.h) |
| DLL- | WUDFx.dll |