Endpoint specific policies. EndpointPolicies(ReadEndpointID).
Declaration Syntax
C# | Visual Basic | Visual C++ |
public class PipePolicies
Public Class PipePolicies
public ref class PipePolicies
Members
All Members | Methods | Properties | |||
Icon | Member | Description |
---|---|---|
AllowPartialReads |
If the allow partial reads policy parameter is FALSE (that is, zero), the read request fails whenever the device returns more data than the client requested.
If the allow partial reads policy parameter is TRUE, the WinUSB driver saves the extra data and sends the extra data to the client during the client's next read.
The default value of the allow partial reads policy parameter is TRUE.
| |
AutoClearStall |
If the auto clear stall policy parameter is TRUE (that is, nonzero), the driver fails stalled data transfers, but the driver clears the stall condition automatically, and data continues to flow on the pipe. This policy parameter does not affect control pipes.
The default value for the auto clear stall policy parameter is FALSE.
| |
AutoFlush |
The auto flush policy parameter works with allow partial reads. If allow partial reads is FALSE, the WinUSB driver ignores the value of auto flush. If allow partial reads is TRUE, the value of auto flush determines what the WinUSB driver does when the device returns more data than the client requested.
If both allow partial reads and auto flush policy parameters are TRUE (that is, nonzero) and the device returns more data than the client requested, the remaining data is discarded. If allow partial reads is TRUE, but auto flush is FALSE, the WinUSB driver caches the extra data and sends it to the client in the next read operation.
The default value of the auto flush policy parameter is FALSE.
| |
IgnoreShortPackets |
If the ignore short packets policy parameter is TRUE (that is, nonzero), the host does not complete a read operation after it receives a short packet. Instead, the the host completes the operation only after the host has read the specified number of bytes.
If the ignore short packets policy parameter is FALSE, the host completes a read operation when either the host has read the specified number of bytes or the host has received a short packet.
The default value of the ignore short packets policy parameter is FALSE.
| |
MaxTransferSize |
The maximum number of bytes that can be transferred at once.
| |
PipeTransferTimeout |
The pipe transfer timeout policy parameter specifies the time-out interval, in milliseconds. The host cancels transfers that do not complete within the time-out interval. A value of zero means that transfers do not time out.
By default, the time-out value is zero, and the host never cancels a transfer because of a time-out.
| |
RawIo |
If the raw i/o policy parameter is TRUE (that is, nonzero), calls to WinUsb_ReadPipe and WinUsb_WritePipe for the specified endpoint must satisfy the following conditions:
The buffer length must be a multiple of the maximum endpoint packet size.
The length must be less than what the host controller supports.
If the preceding conditions are met, WinUSB sends data directly to the USB driver stack, bypassing WinUSB's queuing and error handling.
If the raw i/o policy parameter is FALSE, no restrictions are imposed on the buffers that are passed to WinUsb_ReadPipe and WinUsb_WritePipe.
The default value of the raw i/o policy parameter is FALSE.
| |
ShortPacketTerminate |
If the short packet terminate policy parameter is TRUE (that is, nonzero), every write request that is a multiple of the maximum packet size for the endpoint is terminated with a zero-length packet.
The default value of the short packet terminate policy parameter is FALSE.
| |
ToString()()()() | (Overrides Object.ToString()()()().) |
Inheritance Hierarchy
Object | |
PipePolicies |