WDF_USB_PIPE_INFORMATION Struktur (wdfusb.h)

Artikel
02/07/2025

[Gilt für KMDF und UMDF]

Die WDF_USB_PIPE_INFORMATION-Struktur enthält Informationen zu einem USB-Pipe und seinem Endpunkt.

Syntax

typedef struct _WDF_USB_PIPE_INFORMATION {
  ULONG             Size;
  ULONG             MaximumPacketSize;
  UCHAR             EndpointAddress;
  UCHAR             Interval;
  UCHAR             SettingIndex;
  WDF_USB_PIPE_TYPE PipeType;
  ULONG             MaximumTransferSize;
} WDF_USB_PIPE_INFORMATION, *PWDF_USB_PIPE_INFORMATION;

Angehörige

Size

Die Größe dieser Struktur in Byte.

MaximumPacketSize

Die maximale Paketgröße in Bytes, die der Endpunkt der Pipe senden oder empfangen kann.

Bei hochgeschwindigkeits-isochronen Endpunkten enthält das empfangene MaximumPacketSize Wert die Anzahl der Bytes, die in zusätzlichen Transaktionen übertragen werden können, wenn der Endpunkt sie unterstützt.

EndpointAddress

Die Adresse des Endpunkts auf dem USB-Gerät. Weitere Informationen zu Endpunktadressen finden Sie in der USB-Spezifikation.

Interval

Das Abrufintervall des Endpunkts, wenn das PipeType Member auf WdfUsbPipeTypeInterruptfestgelegt ist. Weitere Informationen zu Abrufintervallen finden Sie in der USB-Spezifikation.

SettingIndex

Ein Indexwert, der die alternative Einstellung innerhalb einer Schnittstelle identifiziert, zu der die Pipe gehört. Weitere Informationen zu alternativen Einstellungen finden Sie in der USB-Spezifikation.

PipeType

Ein WDF_USB_PIPE_TYPE-typd-Wert, der den Typ der Pfeife angibt.

MaximumTransferSize

Dieses Element wird nicht verwendet.

Bemerkungen

Die WDF_USB_PIPE_INFORMATION Struktur wird von der WdfUsbTargetPipeGetInformation, WdfUsbInterfaceGetConfiguredPipeund WdfUsbInterfaceGetEndpointInformation Methoden ausgefüllt.

Um eine WDF_USB_PIPE_INFORMATION Struktur zu initialisieren, sollte ihr Treiber WDF_USB_PIPE_INFORMATION_INITaufrufen.

Weitere Informationen zum MaximumPacketSize Member dieser Struktur finden Sie im Abschnitt "Hinweise" von USBD_PIPE_INFORMATION.

Informationen zum Übertragen von Daten an und von unterstützten isochronen Endpunkten in einem USB-Gerät finden Sie unter Übertragen von Daten an USB Isochrone Endpunkte.