structure USBD_ENDPOINT_OFFLOAD_INFORMATION (usb.h)

Article
02/07/2025

Stocke les informations V2 spécifiques à xHCI utilisées par les pilotes clients pour transférer des données vers et depuis les points de terminaison déchargés.

Syntaxe

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;

Membres

Size

Taille de cette structure.

EndpointAddress

Spécifie l’adresse de point de terminaison définie par USB.

ResourceId

Identificateur de ressource.

Mode

Valeur USBD_ENDPOINT_OFFLOAD_MODE qui indique si le déchargement de point de terminaison est géré dans les logiciels ou le périphérique USB ou le contrôleur hôte.

RootHubPortNumber

Numéro de port du hub racine auquel l’appareil est connecté.

RouteString

Chaîne de routage décrivant le chemin d’accès du hub racine vers l’appareil.

Speed

Vitesse du périphérique USB.

UsbDeviceAddress

Adresse USB de l’appareil.

SlotId

ID d’emplacement de l’appareil.

MultiTT

Indique si l’appareil est connecté à un hub avec des traducteurs de transactions.

LSOrFSDeviceConnectedToTTHub

Indique si l’appareil est un appareil à faible vitesse ou plein débit connecté à un hub avec des traducteurs de transactions.

Reserved0

Réservé.

TransferSegmentLA

Adresse physique du segment d’anneau de transfert.

TransferSegmentVA

Adresse virtuelle du segment d’anneau de transfert.

TransferRingSize

Taille de l’anneau de transfert.

TransferRingInitialCycleBit

Bit de cycle initial de l’anneau de transfert.

MessageNumber

Numéro de message de l’anneau d’événements secondaire.

EventRingSegmentLA

Adresse physique du segment d’anneau d’événements.

EventRingSegmentVA

Adresse virtuelle du segment d’anneau d’événements.

EventRingSize

Taille de l’anneau d’événements, en octets.

EventRingInitialCycleBit

Bit de cycle initial de l’anneau d’événements.

ClientTransferRingSegmentPAIn

Adresse physique du segment d’anneau de transfert fourni par le client.

ClientTransferRingSizeIn

Taille du segment d’anneau de transfert fourni par le client.

ClientDataBufferPAIn

Adresse physique de la mémoire tampon de données fournie par le client.

ClientDataBufferSizeIn

Taille de la mémoire tampon de données fournie par le client.

ClientDataBufferLAOut

Adresse physique de la mémoire tampon de données mappée.

ClientDataBufferVAOut

Adresse virtuelle de la mémoire tampon de données mappée.

Remarques

Cette structure doublons et étend USBD_ENDPOINT_OFFLOAD_INFORMATION_V1.

Cette structure prend en charge deux versions, indiquées par USBD_ENDPOINT_OFFLOAD_INFORMATION et USBD_ENDPOINT_OFFLOAD_INFORMATION_V2, ce dernier incluant éventuellement des champs supplémentaires au-delà de ce qui est documenté ici. La structure facilite la configuration et la gestion détaillées du déchargement du point de terminaison USB.

voir aussi

USBD_ENDPOINT_OFFLOAD_INFORMATION_V1

Exigences

Exigence	Valeur
client minimum pris en charge	Windows 10, version 1709
serveur minimum pris en charge	Windows Server 2016
d’en-tête	usb.h

Partager via