WDF_USB_PIPE_INFORMATION-Struktur (wdfusb.h)

Artikel
02/27/2024

[Gilt für KMDF und UMDF]

Die WDF_USB_PIPE_INFORMATION-Struktur enthält Informationen zu einer USB-Pipe und ihrem 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;

Member

Size

Die Größe (in Bytes) dieser Struktur.

MaximumPacketSize

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

Bei isochronen Hochgeschwindigkeitsendpunkten enthält der empfangene MaximumPacketSize-Wert die Anzahl von Bytes, die in zusätzlichen Transaktionen übertragen werden können, sofern sie vom Endpunkt unterstützt werden.

EndpointAddress

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

Interval

Das Abfrageintervall des Endpunkts, wenn das PipeType-Element auf WdfUsbPipeTypeInterrupt festgelegt 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 typisierter Wert, der den Typ der Pipe angibt.

MaximumTransferSize

Dieses Element wird nicht verwendet.

Hinweise

Die WDF_USB_PIPE_INFORMATION-Struktur wird von den Methoden WdfUsbTargetPipeGetInformation, WdfUsbInterfaceGetConfiguredPipe und WdfUsbInterfaceGetEndpointInformation ausgefüllt.

Um eine WDF_USB_PIPE_INFORMATION Struktur zu initialisieren, sollte Ihr Treiber WDF_USB_PIPE_INFORMATION_INIT aufrufen.

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

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