WdfUsbInterfaceGetNumEndpoints-Funktion (wdfusb.h)
[Gilt für KMDF und UMDF]
Die WdfUsbInterfaceGetNumEndpoints-Methode gibt die Anzahl von Endpunkten zurück, die einer angegebenen alternativen Einstellung einer angegebenen USB-Schnittstelle zugeordnet sind.
Syntax
BYTE WdfUsbInterfaceGetNumEndpoints(
[in] WDFUSBINTERFACE UsbInterface,
[in] UCHAR SettingIndex
);
Parameter
[in] UsbInterface
Ein Handle für ein USB-Schnittstellenobjekt, das durch aufrufen von WdfUsbTargetDeviceGetInterface abgerufen wurde.
[in] SettingIndex
Ein Indexwert, der eine alternative Einstellung für die Schnittstelle identifiziert. Weitere Informationen zu alternativen Einstellungen finden Sie in der USB-Spezifikation.
Rückgabewert
Wenn der angegebene Index gültig ist, gibt WdfUsbInterfaceGetNumEndpoints die Anzahl von Endpunkten zurück, die der alternativen Einstellung der angegebenen Schnittstelle zugeordnet sind. Andernfalls gibt die Methode null zurück.
Eine Fehlerüberprüfung tritt auf, wenn der Treiber ein ungültiges Objekthandle bereitstellt.
Hinweise
Weitere Informationen zur WdfUsbInterfaceGetNumEndpoints-Methode und zu USB-E/A-Zielen finden Sie unter USB-E/A-Ziele.
Beispiele
Im folgenden Codebeispiel wird die Anzahl der Endpunkte für die alternative Einstellung 0 einer angegebenen USB-Schnittstelle abgerufen.
BYTE numEndpoints;
numEndpoints = WdfUsbInterfaceGetNumEndpoints(
UsbInterface,
0
);
Anforderungen
| Anforderung | Wert |
|---|---|
| Zielplattform | Universell |
| KMDF-Mindestversion | 1.0 |
| 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) |