Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
[Gilt für KMDF und UMDF]
Die WdfUsbInterfaceGetNumSettings Methode gibt die Anzahl der alternativen Einstellungen zurück, die eine angegebene USB-Schnittstelle unterstützt.
Syntax
BYTE WdfUsbInterfaceGetNumSettings(
[in] WDFUSBINTERFACE UsbInterface
);
Parameter
[in] UsbInterface
Ein Handle für ein USB-Schnittstellenobjekt, das durch Aufrufen WdfUsbTargetDeviceGetInterfaceabgerufen wurde.
Rückgabewert
WdfUsbInterfaceGetNumSettings gibt die Anzahl der alternativen Einstellungen zurück, die die angegebene USB-Schnittstelle unterstützt.
Wenn der Treiber ein ungültiges Objekthandle bereitstellt, tritt eine Fehlerüberprüfung auf.
Bemerkungen
Ihr Treiber kann WdfUsbInterfaceGetNumSettings aufrufen, nachdem er WdfUsbTargetDeviceCreateWithParametersaufgerufen hat.
Weitere Informationen zur WdfUsbInterfaceGetNumSettings Methode und USB-E/A-Zielen finden Sie unter USB-E/A-Ziele.
Beispiele
Im folgenden Codebeispiel wird die Anzahl der alternativen Einstellungen abgerufen, die für eine angegebene USB-Schnittstelle verfügbar sind.
BYTE altSettings;
altSettings = WdfUsbInterfaceGetNumSettings(UsbInterface);
Anforderungen
| Anforderung | Wert |
|---|---|
| Zielplattform- | Universal |
| Minimale KMDF-Version | 1.5 |
| 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) |
Siehe auch
WdfUsbTargetDeviceCreateWithParameters