wdfusb.h) (WDF_USB_PIPE_INFORMATION 结构

  • 项目

[适用于 KMDF 和 UMDF]

WDF_USB_PIPE_INFORMATION 结构包含有关 USB 管道及其终结点的信息。

语法

typedef struct _WDF_USB_PIPE_INFORMATION {
  ULONG             Size;
  ULONG             MaximumPacketSize;
  UCHAR             EndpointAddress;
  UCHAR             Interval;
  UCHAR             SettingIndex;
  WDF_USB_PIPE_TYPE PipeType;
  ULONG             MaximumTransferSize;
} WDF_USB_PIPE_INFORMATION, *PWDF_USB_PIPE_INFORMATION;

成员

Size

此结构的大小（以字节为单位）。

MaximumPacketSize

管道的终结点能够发送或接收的最大数据包大小（以字节为单位）。

对于高速常时等量终结点，接收的 MaximumPacketSize 值包括可在其他事务中传输的字节数（如果终结点支持这些字节）。

EndpointAddress

USB 设备上终结点的地址。 有关终结点地址的详细信息，请参阅 USB 规范。

Interval

如果 PipeType 成员设置为 WdfUsbPipeTypeInterrupt，则终结点的轮询间隔。 有关轮询间隔的详细信息，请参阅 USB 规范。

SettingIndex

一个索引值，该值标识管道所属的接口中的备用设置。 有关备用设置的详细信息，请参阅 USB 规范。

PipeType

一个WDF_USB_PIPE_TYPE类型的值，该值指定管道的类型。

MaximumTransferSize

未使用此成员。

注解

WDF_USB_PIPE_INFORMATION结构由 WdfUsbTargetPipeGetInformation、WdfUsbInterfaceGetConfiguredPipe 和 WdfUsbInterfaceGetEndpointInformation 方法填充。

若要初始化 WDF_USB_PIPE_INFORMATION 结构，驱动程序应调用 WDF_USB_PIPE_INFORMATION_INIT。

有关此结构的 MaximumPacketSize 成员的详细信息，请参阅 USBD_PIPE_INFORMATION 的“备注”部分。

有关如何在 USB 设备中向/从支持的常时等量终结点传输数据的信息，请参阅 如何将数据传输到 USB 常时等量终结点。

要求

要求 值
最低 KMDF 版本 1.0
最低 UMDF 版本 2.0
标头 wdfusb.h (包括 Wdfusb.h)

另请参阅

USBD_PIPE_INFORMATION

WDF_USB_PIPE_INFORMATION_INIT

WDF_USB_PIPE_TYPE

WdfUsbInterfaceGetConfiguredPipe

WdfUsbInterfaceGetEndpointInformation

WdfUsbTargetPipeGetInformation