<< Previous | Next >>

OSTaskDelReq

INT8U OSTaskDelReq( INT8U prio );

Description

Notifies a task to delete itself. A well-behaved task is deleted when it regains control of the CPU by calling OSTaskDelReq (OSTaskDelReq) and monitoring the return value.

Parameters

prio

The priority of the task that is being asked to delete itself. OS_PRIO_SELF is used when asking whether another task wants the current task to be deleted.

Return value

OS_NO_ERR

The task exists and the request has been registered.

OS_TASK_NOT_EXIST

The task has been deleted. This allows the caller to know whether the request has been executed.

OS_TASK_DEL_IDLE

If requesting to delete uC/OS-II's idletask.

OS_PRIO_INVALID

The priority specified is higher than the maximum allowed (i.e. ≥ OS_LOWEST_PRIO) or, OS_PRIO_SELF is not specified.

OS_TASK_DEL_REQ

A task (possibly another task) requested that the running task be deleted.

Library

UCOS2.LIB

See also

OSTaskDel