This topic has not yet been rated - Rate this topic

TCP_INITIAL_RTO_PARAMETERS structure

The TCP_INITIAL_RTO_PARAMETERS structure specifies data used by the SIO_TCP_INITIAL_RTO IOCTL to configure initial re-transmission timeout (RTO) parameters to be used on the socket.

Syntax

C++


typedef struct _TCP_INITIAL_RTO_PARAMETERS {
  USHORT Rtt;
  UCHAR  MaxSynRetransmissions;
} TCP_INITIAL_RTO_PARAMETERS, *PTCP_INITIAL_RTO_PARAMETERS;

Members

Rtt: Supplies the initial RTT in milliseconds.
MaxSynRetransmissions: Supplies the number of retransmissions attempted before the connection setup fails.

Remarks

The TCP_INITIAL_RTO_PARAMETERS structure allows an application to configure the initial round trip time (RTT) used to compute the retransmission timeout. The application can also configure the number of re-transmissions that will be attempted before the connection attempt fails.

An application should supply the RTT of choice in milliseconds and the maximum number of retransmissions in this structure. The Windows TCP/IP stack will honor these parameters for the subsequent connection attempt. The retransmission behavior for TCP is documented in IETF RFC 793 and 2988.

An application may use the unspecified defines, TCP_INITIAL_RTO_UNSPECIFIED_RTT and TCP_INITIAL_RTO_UNSPECIFIED_MAX_SYN_RETRANSMISSIONS when supplying values for one of these fields. This allows the system to pick up administrator configured settings for the parameter left unspecified.

An application can choose system defaults for any of these fields and supply those values using the default defines, TCP_INITIAL_RTO_DEFAULT_RTT and TCP_INITIAL_RTO_DEFAULT_MAX_SYN_RETRANSMISSIONS.

Requirements

Minimum supported client	Windows 8 [desktop apps only]
Minimum supported server	Windows Server 2012 [desktop apps only]
Header	Mstcpip.h

Community Additions