Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

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

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

Example Usage