WdfUsbInterfaceGetNumSettings-Funktion (wdfusb.h)
[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