|Hint: Use the tree menu to navigate groups of related pages|
|FreeRTOS+UDP was removed from the FreeRTOS kernel download from FreeRTOS V10.1.0. See the FreeRTOS+TCP stack, which can be configured for UDP only use, as an alternative.|
[FreeRTOS Embedded IP Stack API]
void FreeRTOS_ReleaseUDPPayloadBuffer( void *pvBuffer );
FreeRTOS_ReleaseUDPPayloadBuffer() is used to return to the IP stack a buffer that was used with the zero copy interface.
The zero copy interface for transmitting data is described on the FreeRTOS_sendto() documentation page.
The zero copy interface for receiving data is described on the FreeRTOS_recvfrom() documentation page.
A buffer needs to be returned to the stack if:
It is obtained from a call to FreeRTOS_recvfrom() and the data it contains
is no longer required, or
- It was obtained from a call to FreeRTOS_GetUDPPayloadBuffer() but the buffer could not be passed into the IP stack (the call to FreeRTOS_sendto() in which the buffer was used failed).
The buffer that is being returned to the IP stack.
The FreeRTOS_sendto() documentation page includes an example zero copy send operation that demonstrates how to use FreeRTOS_ReleaseUDPPayloadBuffer() when the send operation fails.
the FreeRTOS_recvfrom() documentation page includes an example that demonstrates how to use FreeRTOS_ReleaseUDPPayloadBuffer() to release a buffer obtained from a call to FreeRTOS_recvfrom().