usb.h) (USBD_ENDPOINT_OFFLOAD_INFORMATION 结构

存储特定于 xHCI 的 V2 信息,客户端驱动程序使用该信息向/从卸载的终结点传输数据。

语法

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

设备的槽 ID。

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_INFORMATIONUSBD_ENDPOINT_OFFLOAD_INFORMATION_V2指示,后者可能包含此处所述的其他字段。 该结构有助于详细配置和管理 USB 终结点卸载。

see-also

要求

要求
最低受支持的客户端 Windows 10 版本 1709
最低受支持的服务器 Windows Server 2016
标头 usb.h