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)

Weitere Informationen

WdfUsbTargetDeviceGetInterface