StreamSocketControl.OutboundBufferSizeInBytes | outboundBufferSizeInBytes property

Applies to Windows and Windows Phone

The size, in bytes, of the send buffer to be used for sending data on a StreamSocket object.

Syntax


var outboundBufferSizeInBytes = streamSocketControl.outboundBufferSizeInBytes;
streamSocketControl.outboundBufferSizeInBytes = outboundBufferSizeInBytes;

Property value

Type: Number [JavaScript] | System.UInt32 [.NET] | uint32 [C++]

The size, in bytes, of the send buffer to be used for sending data.

Remarks

The OutboundBufferSizeInBytes property sets the value of the SO_SNDBUF socket option on the TCP socket used by the StreamSocket. The default value is the local computer's default send buffer size. This value varies based on the system memory size. For more detailed information, see SOL_SOCKET Socket Options in the Windows Sockets documentation.

For most apps, this property should not be set since this disables TCP send auto-tuning by the system on this StreamSocket object. With TCP send auto-tuning disabled, network throughput is often worse especially on a connections with high latency. So this property should only be used in very specific situations.

The OutboundBufferSizeInBytes property must be set before the StreamSocket is connected. Setting this property after the StreamSocket is connected has no effect.

Requirements

Minimum supported client

Windows 8

Minimum supported server

Windows Server 2012

Minimum supported phone

Windows Phone 8

Namespace

Windows.Networking.Sockets
Windows::Networking::Sockets [C++]

Metadata

Windows.winmd

DLL

Windows.Networking.dll

Capabilities

ID_CAP_NETWORKING [Windows Phone]

See also

Other resources
How to use advanced socket controls (HTML)
How to use advanced socket controls (XAML)
Reference
SOL_SOCKET Socket Options
StreamSocket
StreamSocketControl

 

 

Show:
© 2014 Microsoft