WDF_USB_PIPE_INFORMATION结构(wdfusb.h)
[适用于 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