IPC@CHIP® RTOS-PPC – API Documentation
This API sends a message to a Message Exchange.
If tasks are waiting for a message from this exchange, this message will be given immediately to the first task waiting at the highest wait priority. If the task accepting the message is higher priority than the task calling this API, then an immediate task switch will result.
If no task was waiting for a message, then the message is stored at the Message Exchange in the specified priority
Each of the Message Exchanges four priority mailboxes was created with a limit on how many messages are allowed to be placed into the respective mailbox. This API will return with error code RTX_EC_MAILBOX_FULL if this limit has been reached and no message delivery results.
The messages are delivered from these mailboxes in FIFO order. The higher priority mailboxes are always emptied (delivered) first before resorting to the lower priority mailboxes.
This API may be called from inside an RTX ISR.