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) |
另请参阅
WdfUsbInterfaceGetConfiguredPipe