Description
Aborts and readies any tasks currently waiting on an event flag group. This function would be used by another task to fault abort the wait on the event flag group, rather than to normally signal the event flag group via OSFlagPost()
.
Files
os.h/os_flag.c
Prototype
Arguments
p_grp
is a pointer to the event flag group for which pend(s) must be aborted.
...
No task was aborted since no task was waiting.
Returned Value
OSFlagPendAbort()
returns the number of tasks made ready-to-run by this function. Zero indicates that no tasks were pending on the event flag group and thus this function had no effect.
Required Configuration
OS_CFG_FLAG_EN
and OS_CFG_FLAG_PEND_ABORT_EN
must be enabled in os_cfg.h. Refer to uC-OS-III Configuration Manual
Callers
Application.
Notes/Warnings
- Event flag groups must be created before they are used.