USBD_ENDPOINT_OFFLOAD_INFORMATION struttura (usb.h)

Articolo
05/23/2024

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

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;

Members

Size

Dimensione della struttura.

EndpointAddress

Specifica l'indirizzo dell'endpoint definito da USB.

ResourceId

Identificatore di 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 slot del dispositivo.

MultiTT

Indica se il dispositivo è connesso a un hub con i traduttori delle transazioni.

LSOrFSDeviceConnectedToTTHub

Indica se il dispositivo è un dispositivo a bassa velocità o a velocità completa connessa a un hub con i traduttori delle transazioni.

Reserved0

Riservato.

TransferSegmentLA

Indirizzo fisico del segmento di anello di trasferimento.

TransferSegmentVA

Indirizzo virtuale del segmento di anello di trasferimento.

TransferRingSize

Dimensione dell'anello di trasferimento.

TransferRingInitialCycleBit

Bit iniziale del ciclo 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

Dimensioni dell'anello evento, in byte.

EventRingInitialCycleBit

Bit iniziale del ciclo dell'anello dell'evento.

ClientTransferRingSegmentPAIn

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

ClientTransferRingSizeIn

Dimensione del segmento di anello di trasferimento fornito dal client.

ClientDataBufferPAIn

Indirizzo fisico del buffer dati fornito dal client.

ClientDataBufferSizeIn

Dimensioni del buffer di dati fornito dal client.

ClientDataBufferLAOut

Indirizzo fisico del buffer dati mappato.

ClientDataBufferVAOut

Indirizzo virtuale del buffer dati mappato.

commenti

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 gli ultimi eventualmente inclusi campi aggiuntivi oltre a ciò che è documentato qui. La struttura facilita la configurazione e la gestione dettagliata dell'offload dell'endpoint USB.

vedere-anche

USBD_ENDPOINT_OFFLOAD_INFORMATION_V1

Requisiti

Requisito	Valore
Client minimo supportato	Windows 10, versione 1709
Server minimo supportato	Windows Server 2016
Intestazione	usb.h

Condividi tramite