ipc: icmsg & icbmsg: Fix alloc_tx_buffer() doxygen description

The return values were not correct, and the parameters descriptions
were not too easy to understand.

Signed-off-by: Alberto Escolar Piedras <alberto.escolar.piedras@nordicsemi.no>