WdfUsbInterfaceGetNumEndpoints-Funktion (wdfusb.h)

  • Artikel

[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)

Weitere Informationen

WdfUsbTargetDeviceGetInterface