struttura USBD_ENDPOINT_OFFLOAD_INFORMATION (usb.h)

Articolo
02/07/2025

Archivia informazioni V2 specifiche di xHCI usate dai driver client per trasferire i dati da e verso gli endpoint offloaded.

Sintassi

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;

Membri

Size

Dimensione di questa struttura.

EndpointAddress

Specifica l'indirizzo endpoint definito da USB.

ResourceId

Identificatore della risorsa.

Mode

Valore USBD_ENDPOINT_OFFLOAD_MODE che indica se l'offload dell'endpoint viene gestito nel software o nel dispositivo USB o nel controller host.

RootHubPortNumber

Numero di porta dell'hub radice a cui è connesso il dispositivo.

RouteString

Stringa di route che descrive il percorso dall'hub radice al dispositivo.

Speed

Velocità del dispositivo USB.

UsbDeviceAddress

Indirizzo USB del dispositivo.

SlotId

ID dello slot del dispositivo.

MultiTT

Indica se il dispositivo è connesso a un hub con convertitori di transazioni.

LSOrFSDeviceConnectedToTTHub

Indica se il dispositivo è un dispositivo a bassa velocità o a velocità intera connesso a un hub con traduttori di transazioni.

Reserved0

Riservato.

TransferSegmentLA

Indirizzo fisico del segmento dell'anello di trasferimento.

TransferSegmentVA

Indirizzo virtuale del segmento dell'anello di trasferimento.

TransferRingSize

Dimensione dell'anello di trasferimento.

TransferRingInitialCycleBit

Bit del ciclo iniziale dell'anello di trasferimento.

MessageNumber

Numero di messaggio per l'anello di eventi secondario.

EventRingSegmentLA

Indirizzo fisico del segmento dell'anello di eventi.

EventRingSegmentVA

Indirizzo virtuale del segmento dell'anello di eventi.

EventRingSize

Dimensione dell'anello dell'evento, in byte.

EventRingInitialCycleBit

Bit del ciclo iniziale dell'anello dell'evento.

ClientTransferRingSegmentPAIn

Indirizzo fisico del segmento dell'anello di trasferimento fornito dal client.

ClientTransferRingSizeIn

Dimensioni del segmento dell'anello di trasferimento fornito dal client.

ClientDataBufferPAIn

Indirizzo fisico del buffer di dati fornito dal client.

ClientDataBufferSizeIn

Dimensioni del buffer di dati fornito dal client.

ClientDataBufferLAOut

Indirizzo fisico del buffer di dati mappato.

ClientDataBufferVAOut

Indirizzo virtuale del buffer di dati mappato.

osservazioni

Questa struttura duplica ed estende USBD_ENDPOINT_OFFLOAD_INFORMATION_V1.

Questa struttura supporta due versioni, indicate da USBD_ENDPOINT_OFFLOAD_INFORMATION e USBD_ENDPOINT_OFFLOAD_INFORMATION_V2, con quest'ultima possibilmente inclusi campi aggiuntivi oltre a quanto documentato qui. La struttura facilita la configurazione dettagliata e la gestione dell'offload dell'endpoint USB.

see-also

USBD_ENDPOINT_OFFLOAD_INFORMATION_V1

Fabbisogno

Requisito	Valore
client minimo supportato	Windows 10, versione 1709
server minimo supportato	Windows Server 2016
intestazione	usb.h

Condividi tramite