NetSock_CfgTxQ_Size
Configure socket's transmit queue size.
Files
net_sock.h/net_sock.c
Prototype
CPU_BOOLEAN NetSock_CfgTxQ_Size(NET_SOCK_ID sock_id, NET_SOCK_DATA_SIZE size NET_ERR *p_err);
Arguments
sock_id
This is the socket ID of socket to configure transmit queue size.
size
Desired transmit queue size.
p_err
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_INIT_ERR_NOT_COMPLETED
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_ERR_FAULT_LOCK_ACQUIRE
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 function NetSock_TxData()).
For steam sockets, size may be required to be configured prior to connecting (see function NetTCP_ConnCfgTxWinSize).