структура USBD_ENDPOINT_OFFLOAD_INFORMATION (usb.h)

Статья
02/07/2025

Хранит сведения о xHCI версии 2, которые используются драйверами клиентов для передачи данных в не загруженные конечные точки и из них.

Синтаксис

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;

Члены

Size

Размер этой структуры.

EndpointAddress

Указывает адрес конечной точки, определяемый USB.

ResourceId

Идентификатор ресурса.

Mode

Значение USBD_ENDPOINT_OFFLOAD_MODE, указывающее, обрабатывается ли разгрузка конечной точки программным обеспечением или USB-устройством или контроллером узла.

RootHubPortNumber

Номер порта корневого концентратора, к которому подключено устройство.

RouteString

Строка маршрута, описывающая путь от корневого концентратора к устройству.

Speed

Скорость USB-устройства.

UsbDeviceAddress

USB-адрес устройства.

SlotId

Идентификатор слота устройства.

MultiTT

Указывает, подключено ли устройство к концентратору с переводчиками транзакций.

LSOrFSDeviceConnectedToTTHub

Указывает, является ли устройство низкоскоростным или полноскоростным устройством, подключенным к концентратору с переводчиками транзакций.

Reserved0

Скрытный.

TransferSegmentLA

Физический адрес сегмента кольца передачи.

TransferSegmentVA

Виртуальный адрес сегмента кольца передачи.

TransferRingSize

Размер кольца передачи.

TransferRingInitialCycleBit

Начальный бит цикла кольца передачи.

MessageNumber

Номер сообщения для вторичного кольца событий.

EventRingSegmentLA

Физический адрес сегмента кольца событий.

EventRingSegmentVA

Виртуальный адрес сегмента кольца событий.

EventRingSize

Размер кольца событий в байтах.

EventRingInitialCycleBit

Начальный бит цикла кольца событий.

ClientTransferRingSegmentPAIn

Физический адрес предоставленного клиентом сегмента кольца передачи.

ClientTransferRingSizeIn

Размер сегмента кольца передачи, предоставленного клиентом.

ClientDataBufferPAIn

Физический адрес предоставленного клиентом буфера данных.

ClientDataBufferSizeIn

Размер буфера данных, предоставленного клиентом.

ClientDataBufferLAOut

Физический адрес сопоставленного буфера данных.

ClientDataBufferVAOut

Виртуальный адрес сопоставленного буфера данных.

Замечания

Эта структура дублирует и расширяет USBD_ENDPOINT_OFFLOAD_INFORMATION_V1.

Эта структура поддерживает две версии, указанные в USBD_ENDPOINT_OFFLOAD_INFORMATION и USBD_ENDPOINT_OFFLOAD_INFORMATION_V2, с последним, возможно, включая дополнительные поля, помимо того, что описано здесь. Структура упрощает подробную настройку и управление разгрузкой конечной точки USB.

см. также

USBD_ENDPOINT_OFFLOAD_INFORMATION_V1

Требования

Требование	Ценность
минимальные поддерживаемые клиентские	Windows 10 версии 1709
минимальный поддерживаемый сервер	Windows Server 2016
заголовка	usb.h

Поделиться через