Skip to content

Group xMessageBufferReset

Modules > xMessageBufferReset


Detailed Description


Resets a message buffer to its initial empty state, discarding any message it contained.

A message buffer can only be reset if there are no tasks blocked on it.


  • xMessageBuffer The handle of the message buffer being reset.


If the message buffer was reset then pdPASS is returned. If the message buffer could not be reset because either there was a task blocked on the message queue to wait for space to become available, or to wait for a a message to be available, then pdFAIL is returned.