Skip to content

Latest commit

 

History

History
88 lines (63 loc) · 3.59 KB

nf-wdfusb-wdfusbtargetpipesetnomaximumpacketsizecheck.md

File metadata and controls

88 lines (63 loc) · 3.59 KB
UID title description old-location tech.root ms.date keywords ms.keywords req.header req.include-header req.target-type req.target-min-winverclnt req.target-min-winversvr req.kmdf-ver req.umdf-ver req.ddi-compliance req.unicode-ansi req.idl req.max-support req.namespace req.assembly req.type-library req.lib req.dll req.irql targetos req.typenames f1_keywords topic_type api_type api_location api_name
NF:wdfusb.WdfUsbTargetPipeSetNoMaximumPacketSizeCheck
WdfUsbTargetPipeSetNoMaximumPacketSizeCheck function (wdfusb.h)
The WdfUsbTargetPipeSetNoMaximumPacketSizeCheck method disables the framework's test of whether the size of a driver's read buffer is a multiple of a USB pipe's maximum packet size.
wdf\wdfusbtargetpipesetnomaximumpacketsizecheck.htm
wdf
02/26/2018
WdfUsbTargetPipeSetNoMaximumPacketSizeCheck function
DFUsbRef_e750d0d1-6d91-498d-8bb5-2eb9bab0149d.xml, WdfUsbTargetPipeSetNoMaximumPacketSizeCheck, WdfUsbTargetPipeSetNoMaximumPacketSizeCheck method, kmdf.wdfusbtargetpipesetnomaximumpacketsizecheck, wdf.wdfusbtargetpipesetnomaximumpacketsizecheck, wdfusb/WdfUsbTargetPipeSetNoMaximumPacketSizeCheck
wdfusb.h
Wdfusb.h
Universal
1.0
2.0
DriverCreate, KmdfIrql, KmdfIrql2, UsbKmdfIrql, UsbKmdfIrql2
Wdf01000.sys (KMDF); WUDFx02000.dll (UMDF)
<=DISPATCH_LEVEL
Windows
WdfUsbTargetPipeSetNoMaximumPacketSizeCheck
wdfusb/WdfUsbTargetPipeSetNoMaximumPacketSizeCheck
APIRef
kbSyntax
LibDef
Wdf01000.sys
Wdf01000.sys.dll
WUDFx02000.dll
WUDFx02000.dll.dll
WdfUsbTargetPipeSetNoMaximumPacketSizeCheck

WdfUsbTargetPipeSetNoMaximumPacketSizeCheck function

-description

[Applies to KMDF and UMDF]

The WdfUsbTargetPipeSetNoMaximumPacketSizeCheck method disables the framework's test of whether the size of a driver's read buffer is a multiple of a USB pipe's maximum packet size.

-parameters

-param Pipe [in]

A handle to a framework pipe object that was obtained by calling WdfUsbInterfaceGetConfiguredPipe.

-remarks

A bug check occurs if the driver supplies an invalid object handle.

To avoid receiving extra data from unexpected bus activity, which is sometimes called babble, drivers usually specify read buffers that are a multiple of the pipe's maximum packet size. (Drivers receive a USB pipe's maximum packet size in a WDF_USB_PIPE_INFORMATION structure.) By default, the framework reports an error if a driver specifies a read buffer that is not a multiple of the pipe's maximum packet size. If the driver calls WdfUsbTargetPipeSetNoMaximumPacketSizeCheck, the framework does not report an error if a read buffer is not a multiple of the maximum packet size.

For more information about the WdfUsbTargetPipeSetNoMaximumPacketSizeCheck method and USB I/O targets, see USB I/O Targets.

Examples

The following code example disables the framework's test of whether the size of a buffer is a multiple of a USB pipe's maximum packet size.

WdfUsbTargetPipeSetNoMaximumPacketSizeCheck(pipe);
 

-see-also

WDF_USB_PIPE_INFORMATION

WdfUsbInterfaceGetConfiguredPipe