WdfUsbInterfaceGetConfiguredSettingIndex-Funktion (wdfusb.h)
[Gilt für KMDF und UMDF]
Die WdfUsbInterfaceGetConfiguredSettingIndex-Methode gibt den Index der alternativen Einstellung zurück, der derzeit für eine angegebene USB-Geräteschnittstelle ausgewählt ist.
Syntax
BYTE WdfUsbInterfaceGetConfiguredSettingIndex(
[in] WDFUSBINTERFACE Interface
);
Parameter
[in] Interface
Ein Handle für ein USB-Schnittstellenobjekt, das durch Aufrufen von WdfUsbTargetDeviceGetInterface abgerufen wurde.
Rückgabewert
Wenn der Vorgang erfolgreich ist, gibt WdfUsbInterfaceGetConfiguredSettingIndex den Index der alternativen Einstellung zurück, der derzeit für die angegebene Schnittstelle ausgewählt ist. Wenn die Schnittstelle nicht konfiguriert ist, gibt die Methode null zurück.
Eine Fehlerüberprüfung tritt auf, wenn der Treiber ein ungültiges Objekthandle bereitstellt.
Hinweise
Weitere Informationen zur WdfUsbInterfaceGetConfiguredSettingIndex-Methode und USB-E/A-Zielen finden Sie unter USB-E/A-Ziele.
Beispiele
Im folgenden Codebeispiel wird der Index für die derzeit ausgewählte alternative Einstellung einer angegebenen USB-Schnittstelle abgerufen.
BYTE settingIndex;
settingIndex = WdfUsbInterfaceGetConfiguredSettingIndex(UsbInterface);
Anforderungen
| Anforderung | Wert |
|---|---|
| Zielplattform | Universell |
| KMDF-Mindestversion | 1.0 |
| UMDF-Mindestversion | 2.0 |
| Kopfzeile | wdfusb.h (wdfusb.h einschließen) |
| Bibliothek | Wdf01000.sys (KMDF); WUDFx02000.dll (UMDF) |
| IRQL | <=DISPATCH_LEVEL |
| DDI-Complianceregeln | DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf), UsbKmdfIrql(kmdf), UsbKmdfIrql2(kmdf), UsbKmdfIrqlExplicit(kmdf) |