WdfUsbTargetPipeSetNoMaximumPacketSizeCheck 函式 (wdfusb.h)
[適用於 KMDF 和 UMDF]
WdfUsbTargetPipeSetNoMaximumPacketSizeCheck 方法會停用架構測試驅動程式讀取緩衝區的大小是否為 USB 管道封包大小上限的倍數。
語法
void WdfUsbTargetPipeSetNoMaximumPacketSizeCheck(
[in] WDFUSBPIPE Pipe
);
參數
[in] Pipe
呼叫 WdfUsbInterfaceGetConfiguredPipe 取得之架構管道物件的句柄。
傳回值
無
備註
如果驅動程式提供無效的物件句柄,就會發生錯誤檢查。
為了避免從非預期的總線活動接收額外的數據,有時稱為 babble,驅動程式通常會指定多個管道封包大小上限的讀取緩衝區。 (驅動程式在 WDF_USB_PIPE_INFORMATION structure.) 收到 USB 管道的最大封包大小。根據預設,如果驅動程式指定不是管道最大封包大小的多個讀取緩衝區,架構就會回報錯誤。 如果驅動程式呼叫 WdfUsbTargetPipeSetNoMaximumPacketSizeCheck,則如果讀取緩衝區不是封包大小上限的倍數,架構就不會回報錯誤。
如需 WdfUsbTargetPipeSetNoMaximumPacketSizeCheck 方法和 USB I/O 目標的詳細資訊,請參閱 USB I/O 目標。
範例
下列程式代碼範例會停用架構測試緩衝區大小是否為USB管道封包大小上限的倍數。
WdfUsbTargetPipeSetNoMaximumPacketSizeCheck(pipe);
規格需求
需求 | 值 |
---|---|
目標平台 | Universal |
最低 KMDF 版本 | 1.0 |
最低UMDF版本 | 2.0 |
標頭 | wdfusb.h (包含 Wdfusb.h) |
程式庫 | Wdf01000.sys (KMDF) ;WUDFx02000.dll (UMDF) |
IRQL | <=DISPATCH_LEVEL |
DDI 合規性規則 | DriverCreate (kmdf) , KmdfIrql (kmdf) , KmdfIrql2 (kmdf) , KmdfIrqlExplicit (kmdf) , UsbKmdfIrql (kmdf) 、 UsbKmdfIrql2 (kmdf) 、UsbKmdfIrqlExplicit (kmdf) |