USBD_ENDPOINT_OFFLOAD_INFORMATION-Struktur (usb.h)

Artikel
05/23/2024

Speichert xHCI-spezifische V2-Informationen, die von Clienttreibern zum Übertragen von Daten zu und von den ausgeladenen Endpunkten verwendet werden.

Syntax

typedef struct _USBD_ENDPOINT_OFFLOAD_INFORMATION {
  ULONG                      Size;
  USHORT                     EndpointAddress;
  ULONG                      ResourceId;
  USBD_ENDPOINT_OFFLOAD_MODE Mode;
  ULONG                      RootHubPortNumber : 8;
  ULONG                      RouteString : 20;
  ULONG                      Speed : 4;
  ULONG                      UsbDeviceAddress : 8;
  ULONG                      SlotId : 8;
  ULONG                      MultiTT : 1;
  ULONG                      LSOrFSDeviceConnectedToTTHub : 1;
  ULONG                      Reserved0 : 14;
  PHYSICAL_ADDRESS           TransferSegmentLA;
  PVOID                      TransferSegmentVA;
  size_t                     TransferRingSize;
  ULONG                      TransferRingInitialCycleBit;
  ULONG                      MessageNumber;
  PHYSICAL_ADDRESS           EventRingSegmentLA;
  PVOID                      EventRingSegmentVA;
  size_t                     EventRingSize;
  ULONG                      EventRingInitialCycleBit;
  PHYSICAL_ADDRESS           ClientTransferRingSegmentPAIn;
  size_t                     ClientTransferRingSizeIn;
  PHYSICAL_ADDRESS           ClientDataBufferPAIn;
  size_t                     ClientDataBufferSizeIn;
  PHYSICAL_ADDRESS           ClientDataBufferLAOut;
  PVOID                      ClientDataBufferVAOut;
} USBD_ENDPOINT_OFFLOAD_INFORMATION, *PUSBD_ENDPOINT_OFFLOAD_INFORMATION, USBD_ENDPOINT_OFFLOAD_INFORMATION_V2, *PUSBD_ENDPOINT_OFFLOAD_INFORMATION_V2;

Member

Size

Die Größe dieser Struktur.

EndpointAddress

Gibt die ÜBER USB definierte Endpunktadresse an.

ResourceId

Der Ressourcenbezeichner.

Mode

Ein USBD_ENDPOINT_OFFLOAD_MODE Wert, der angibt, ob die Endpunktausladung in Software oder auf dem USB-Gerät oder Hostcontroller erfolgt.

RootHubPortNumber

Die Portnummer des Stammhubs, mit dem das Gerät verbunden ist.

RouteString

Die Routenzeichenfolge, die den Pfad vom Stammhub zum Gerät beschreibt.

Speed

Die Geschwindigkeit des USB-Geräts.

UsbDeviceAddress

Die USB-Adresse des Geräts.

SlotId

Die Slot-ID des Geräts.

MultiTT

Gibt an, ob das Gerät mit transaktionsübersetzern mit einem Hub verbunden ist.

LSOrFSDeviceConnectedToTTHub

Gibt an, ob es sich bei dem Gerät um ein Gerät mit niedriger Geschwindigkeit oder einem Gerät handelt, das mit einem Hub mit Transaktionsübersetzern verbunden ist.

Reserved0

Reserviert.

TransferSegmentLA

Die physische Adresse des Übertragungsringsegments.

TransferSegmentVA

Die virtuelle Adresse des Übertragungsringsegments.

TransferRingSize

Die Größe des Übertragungsrings.

TransferRingInitialCycleBit

Das Anfängliche Zyklusbit des Übertragungsrings.

MessageNumber

Die Nachrichtennummer für den sekundären Ereignisring.

EventRingSegmentLA

Die physische Adresse des Ereignisringsegments.

EventRingSegmentVA

Die virtuelle Adresse des Ereignisringsegments.

EventRingSize

Die Größe des Ereignisrings in Bytes.

EventRingInitialCycleBit

Das Anfängliche Zyklusbit des Ereignisrings.

ClientTransferRingSegmentPAIn

Die physische Adresse des vom Client bereitgestellten Übertragungsringsegments.

ClientTransferRingSizeIn

Die Größe des vom Client bereitgestellten Übertragungsringsegments.

ClientDataBufferPAIn

Die physische Adresse des vom Client bereitgestellten Datenpuffers.

ClientDataBufferSizeIn

Die Größe des vom Client bereitgestellten Datenpuffers.

ClientDataBufferLAOut

Die physische Adresse des zugeordneten Datenpuffers.

ClientDataBufferVAOut

Die virtuelle Adresse des zugeordneten Datenpuffers.

Hinweise

Diese Struktur dupliziert und erweitert USBD_ENDPOINT_OFFLOAD_INFORMATION_V1.

Diese Struktur unterstützt zwei Versionen, die durch USBD_ENDPOINT_OFFLOAD_INFORMATION und USBD_ENDPOINT_OFFLOAD_INFORMATION_V2angegeben werden, wobei letztere möglicherweise zusätzliche Felder enthält, die über das hier dokumentierte hinaus gehen. Die Struktur ermöglicht eine detaillierte Konfiguration und Verwaltung der USB-Endpunktauslagerung.

Siehe auch

USBD_ENDPOINT_OFFLOAD_INFORMATION_V1

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 10, Version 1709
Unterstützte Mindestversion (Server)	Windows Server 2016
Kopfzeile	usb.h

Freigeben über