Configure socket's transmit queue size.
Files
net_sock.h/net_sock.c
Prototype
Arguments
sock_id
This is the socket ID of socket to configure transmit queue size.
size
Desired transmit queue size.
perr
Pointer to variable that will receive the return error code from this function:
NET_SOCK_ERR_NONE
NET_SOCK_ERR_INVALID_TYPE
NET_SOCK_ERR_INVALID_PROTOCOL
NET_SOCK_ERR_INVALID_DATA_SIZE
NET_ERR_INIT_INCOMPLETE
NET_SOCK_ERR_INVALID_SOCK
NET_SOCK_ERR_NOT_USED
NET_TCP_ERR_INVALID_CONN
NET_TCP_ERR_INVALID_ARG
NET_TCP_ERR_CONN_NOT_USED
NET_CONN_ERR_INVALID_CONN
NET_CONN_ERR_NOT_USED
NET_OS_ERR_LOCK
Returned Value
DEF_OK
,
Socket transmit queue size successfully configured;
DEF_FAIL
,
otherwise.
Required Configuration
None.
Notes / Warnings
For datagram sockets, configured size does not:
- Partially truncate any transmitted data but instead allows data from exactly one transmitted packet buffer to overflow the configured size since each datagram must be transmitted atomically (see section C-13-48 “NetSock_TxData() / send() (TCP) NetSock_TxDataTo() / sendto() (UDP)”).
For steam sockets, size may be required to be configured prior to connecting (see section C-14-6 “NetTCP_ConnCfgTxWinSize()”).