1.2.3.1.27 TCPIP_TCP_Flush Function

C

bool TCPIP_TCP_Flush(
    TCP_SOCKET hTCP
);

Description

This function immediately transmits all pending TX data with a PSH flag. If this function is not called, data will automatically be sent by the TCP state machine (see the TCPIP_TCP_ArrayPut() description/notes).

Preconditions

TCP is initialized and the socket is connected.

Parameters

ParametersDescription
hTCPThe socket whose data is to be transmitted.

Returns

  • True - If data is flushed from the socket.

  • False - Otherwise.

Remarks

The application should not call this function explicitly because doing this will interfere with the TCP algorithm and degrade performance of the socket data transfer. One exception is when the application knows that it put all the data it needed into the TCP buffer and it makes sense to flush the socket instead of waiting TCP_AUTO_TRANSMIT_TIMEOUT_VAL timeout to elapse.