SIO_WSK_SET_TCP_SILENT_MODE control code

The SIO_WSK_SET_TCP_SILENT_MODE socket I/O control operation allows a WSK client to enable silent mode on the TCP connection.

A TCP connection in silent mode will not send any data or control packets on the wire. This socket I/O control operation applies only to connected TCP sockets. It is not supported on loopback.

To perform this operation, call the WskControlSocket function with the following parameters.

Parameters

RequestType [in]

Use WskIoctl for this operation.

ControlCode [in]

The control code for the operation. Use SIO_WSK_SET_TCP_SILENT_MODE for this operation.

Level

Use zero for this operation.

InputSize [in]

Use zero for this operation.

InputBuffer [in]

Use NULL for this operation.

OutputSize [out]

Use zero for this operation.

OutputBuffer [in]

Use NULL for this operation.

OutputSizeReturned [out]

Use NULL for this operation.

Remarks

A WSK application must specify a pointer to an IRP when calling the WskControlSocket function to enable silent mode.

The WSK application before calling WskControlSocket to enable silent mode must ensure that there are no pending send or disconnect requests.

WskControlSocket will return STATUS_SUCCESS when silent mode is enabled. Once silent mode is enabled, send and disconnect requests will be failed with STATUS_INVALID_DEVICE_STATE and all received control or data packets will be discarded silently.

The only valid operation on this socket is WskCloseSocket.

Requirements

Version

Available in Windows 8, Windows Server 2012, and later.

Header

Wsk.h (include Wsk.h)

See also

WskCloseSocket
WskControlSocket

 

 

Send comments about this topic to Microsoft

Show:
© 2014 Microsoft