estructura USBD_ENDPOINT_OFFLOAD_INFORMATION (usb.h)

Artículo
05/23/2024

Almacena información V2 específica de xHCI que usan los controladores de cliente para transferir datos hacia y desde los puntos de conexión descargados.

Sintaxis

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;

Miembros

Size

Tamaño de esta estructura.

EndpointAddress

Especifica la dirección del punto de conexión definido por USB.

ResourceId

Identificador del recurso.

Mode

Valor de USBD_ENDPOINT_OFFLOAD_MODE que indica si la descarga de puntos de conexión se controla en software o en el dispositivo USB o el controlador host.

RootHubPortNumber

Número de puerto del centro raíz al que está conectado el dispositivo.

RouteString

Cadena de ruta que describe la ruta de acceso desde el centro raíz al dispositivo.

Speed

Velocidad del dispositivo USB.

UsbDeviceAddress

Dirección USB del dispositivo.

SlotId

Identificador de ranura del dispositivo.

MultiTT

Indica si el dispositivo está conectado a un centro con traductores de transacciones.

LSOrFSDeviceConnectedToTTHub

Indica si el dispositivo es un dispositivo de baja velocidad o de velocidad completa conectado a un centro con traductores de transacciones.

Reserved0

Reservado.

TransferSegmentLA

Dirección física del segmento de anillo de transferencia.

TransferSegmentVA

Dirección virtual del segmento de anillo de transferencia.

TransferRingSize

Tamaño del anillo de transferencia.

TransferRingInitialCycleBit

Bit de ciclo inicial del anillo de transferencia.

MessageNumber

Número de mensaje del anillo de eventos secundario.

EventRingSegmentLA

Dirección física del segmento de anillo de eventos.

EventRingSegmentVA

Dirección virtual del segmento del anillo de eventos.

EventRingSize

Tamaño del anillo de eventos, en bytes.

EventRingInitialCycleBit

Bit de ciclo inicial del anillo de eventos.

ClientTransferRingSegmentPAIn

Dirección física del segmento de anillo de transferencia proporcionado por el cliente.

ClientTransferRingSizeIn

Tamaño del segmento de anillo de transferencia proporcionado por el cliente.

ClientDataBufferPAIn

Dirección física del búfer de datos proporcionado por el cliente.

ClientDataBufferSizeIn

Tamaño del búfer de datos proporcionado por el cliente.

ClientDataBufferLAOut

Dirección física del búfer de datos asignado.

ClientDataBufferVAOut

Dirección virtual del búfer de datos asignado.

comentarios

Esta estructura duplica y extiende USBD_ENDPOINT_OFFLOAD_INFORMATION_V1.

Esta estructura admite dos versiones, indicadas por USBD_ENDPOINT_OFFLOAD_INFORMATION y USBD_ENDPOINT_OFFLOAD_INFORMATION_V2, con este último posiblemente incluir campos adicionales más allá de lo que se documenta aquí. La estructura facilita la configuración y administración detalladas de la descarga del punto de conexión USB.

see-also

USBD_ENDPOINT_OFFLOAD_INFORMATION_V1

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows 10, versión 1709
Servidor mínimo compatible	Windows Server 2016
Encabezado	usb.h

Share via