WdfUsbInterfaceGetConfiguredSettingIndex-Funktion (wdfusb.h)
[Gilt für KMDF und UMDF]
Die WdfUsbInterfaceGetConfiguredSettingIndex Methode gibt den alternativen Einstellungsindex 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 WdfUsbTargetDeviceGetInterfaceabgerufen wurde.
Rückgabewert
Wenn der Vorgang erfolgreich ist, gibt WdfUsbInterfaceGetConfiguredSettingIndex den alternativen Einstellungsindex zurück, der derzeit für die angegebene Schnittstelle ausgewählt ist. Wenn die Schnittstelle nicht konfiguriert ist, gibt die Methode null zurück.
Wenn der Treiber ein ungültiges Objekthandle bereitstellt, tritt eine Fehlerüberprüfung auf.
Bemerkungen
Weitere Informationen zur WdfUsbInterfaceGetConfiguredSettingIndex Methode und USB-E/A-Zielen finden Sie unter USB-E/A-Ziele.
Beispiele
Das folgende Codebeispiel ruft den Index für die aktuell ausgewählte alternative Einstellung einer angegebenen USB-Schnittstelle ab.
BYTE settingIndex;
settingIndex = WdfUsbInterfaceGetConfiguredSettingIndex(UsbInterface);
Anforderungen
| Anforderung | Wert |
|---|---|
| Zielplattform- | Universal |
| Minimale KMDF-Version | 1.0 |
| Mindest-UMDF-Version | 2.0 |
| Header- | wdfusb.h (include Wdfusb.h) |
| Library | 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) |