WdfUsbInterfaceGetNumSettings-Funktion (wdfusb.h)
[Gilt für KMDF und UMDF]
Die WdfUsbInterfaceGetNumSettings-Methode gibt die Anzahl alternativer Einstellungen zurück, die von einer angegebenen USB-Schnittstelle unterstützt werden.
Syntax
BYTE WdfUsbInterfaceGetNumSettings(
[in] WDFUSBINTERFACE UsbInterface
);
Parameter
[in] UsbInterface
Ein Handle für ein USB-Schnittstellenobjekt, das durch aufrufen von WdfUsbTargetDeviceGetInterface abgerufen wurde.
Rückgabewert
WdfUsbInterfaceGetNumSettings gibt die Anzahl alternativer Einstellungen zurück, die von der angegebenen USB-Schnittstelle unterstützt werden.
Eine Fehlerüberprüfung tritt auf, wenn der Treiber ein ungültiges Objekthandle bereitstellt.
Hinweise
Ihr Treiber kann WdfUsbInterfaceGetNumSettings aufrufen, nachdem er WdfUsbTargetDeviceCreateWithParameters aufgerufen 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 | Universell |
| KMDF-Mindestversion | 1.5 |
| UMDF-Mindestversion | 2.0 |
| Kopfzeile | wdfusb.h (einschließlich Wdfusb.h) |
| 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
WdfUsbTargetDeviceCreateWithParameters