...
If the task receiving the signal is actually waiting for a signal to be received, it will be made ready-to-run and, if the receiving task has a higher priority than the task sending the signal, the higher-priority task resumes, and the task sending the signal is suspended; that is, a context switch occurs. Note that scheduling only occurs if opt is set to OS_OPT_POST_NONE, because the OS_OPT_POST_NO_SCHED option does not cause the scheduler to be called.
Arguments
p_tcb
is a pointer to the TCB of the task being signaled. A NULL pointer indicates that the user is sending a signal to itself.
...
the post would have caused the semaphore counter to overflow.
Returned Value
The current value of the task’s signal counter, or 0 if called from an ISR and OS_CFG_ISR_POST_DEFERRED_EN is set to 1.
Notes/Warnings
None