OS_OBJ_QTY OSFlagPendAbort (OS_SEM *p_grp
,
OS_OPT opt,
OS_ERR *p_err)
File | Called from | Code enabled by |
---|---|---|
| Task only |
|
...
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.
...
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.