WdfUsbTargetPipeSetNoMaximumPacketSizeCheck 函数 (wdfusb.h)

[适用于 KMDF 和 UMDF]

WdfUsbTargetPipeSetNoMaximumPacketSizeCheck 方法禁用框架测试驱动程序的读取缓冲区大小是否是 USB 管道最大数据包大小的倍数。

语法

void WdfUsbTargetPipeSetNoMaximumPacketSizeCheck(
  [in] WDFUSBPIPE Pipe
);

参数

[in] Pipe

通过调用 WdfUsbInterfaceGetConfiguredPipe 获取的框架管道对象的句柄。

返回值

无

备注

如果驱动程序提供无效的对象句柄，则会发生 bug 检查。

为了避免从意外的总线活动（有时称为 babble）接收额外数据，驱动程序通常指定是管道最大数据包大小的倍数的读取缓冲区。 (驱动程序在 WDF_USB_PIPE_INFORMATION 结构中接收 USB 管道的最大数据包大小。) 默认情况下，如果驱动程序指定的读取缓冲区不是管道最大数据包大小的倍数，框架将报告错误。 如果驱动程序调用 WdfUsbTargetPipeSetNoMaximumPacketSizeCheck，则如果读取缓冲区不是最大数据包大小的倍数，则框架不会报告错误。

有关 WdfUsbTargetPipeSetNoMaximumPacketSizeCheck 方法和 USB I/O 目标的详细信息，请参阅 USB I/O 目标。

示例

下面的代码示例禁用框架测试缓冲区的大小是否是 USB 管道最大数据包大小的倍数。

WdfUsbTargetPipeSetNoMaximumPacketSizeCheck(pipe);
 

要求

要求	值
目标平台	通用
最低 KMDF 版本	1.0
最低 UMDF 版本	2.0
标头	wdfusb.h (包括 Wdfusb.h)
Library	Wdf01000.sys (KMDF) ;WUDFx02000.dll (UMDF)
IRQL	<=DISPATCH_LEVEL
DDI 符合性规则	DriverCreate (kmdf) 、 KmdfIrql (kmdf) 、 KmdfIrql2 (kmdf) 、 KmdfIrqlExplicit (kmdf) ， UsbKmdfIrql (kmdf) 、 UsbKmdfIrql2 (kmdf) 、 UsbKmdfIrqlExplicit (kmdf)

另请参阅

WDF_USB_PIPE_INFORMATION

WdfUsbInterfaceGetConfiguredPipe