Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
OS_OBJ_QTY  OSFlagPendAbort (OS_SEM  *p_grp,
                             OS_OPT   opt,
                             OS_ERR  *p_err)

File

Called from

Code enabled by

os_flag.c

Task only

OS_CFG_FLAG_EN and OS_CFG_FLAG_PEND_ABORT_EN

...

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

  1. Event flag groups must be created before they are used.

Example Usage