WdfUsbInterfaceGetNumEndpoints-Funktion (wdfusb.h)

Artikel
02/07/2025

[Gilt für KMDF und UMDF]

Die WdfUsbInterfaceGetNumEndpoints Methode gibt die Anzahl der Endpunkte 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 WdfUsbTargetDeviceGetInterfaceabgerufen 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 der Endpunkte zurück, die der alternativen Einstellung der angegebenen Schnittstelle zugeordnet sind. Andernfalls gibt die Methode null zurück.

Wenn der Treiber ein ungültiges Objekthandle bereitstellt, tritt eine Fehlerüberprüfung auf.

Bemerkungen

Weitere Informationen zu den WdfUsbInterfaceGetNumEndpoints Methode und 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 erhalten.

BYTE  numEndpoints;
numEndpoints = WdfUsbInterfaceGetNumEndpoints(
                                              UsbInterface,
                                              0
                                              );

Anforderungen

Anforderung	Wert
Zielplattform-	Universal
Minimale KMDF-Version	1.0
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

WdfUsbTargetDeviceGetInterface

Freigeben über