www.beck-ipc.com

@CHIP-RTOS C Library - RTOS API


RTX_Delete_Task

Remove specified task from system.

int RTX_Delete_Task ( int taskID );

Parameters

taskID

Task handle returned from RTX_Create_Task or RTX_Create_Task_Without_Run.

Return Value

0, task is removed.
non-zero --> error code.

Comments

You should not delete or kill a task which is waiting on a semaphore, Message Exchange or Event Group.   Same goes for a task that is in possession of a resource type semaphore.   Also the consequences of killing a task that had acquired a counting semaphore must be considered.

After making this call, the taskID is no longer valid.

A task can remove itself.

CAUTION:

    Any memory allocated from the system by the task which is being deleted here will be released.

See Also

RTOS API

This library function invokes a RTOS software interrupt. Refer to this RTOS API function's documentation for more details.

Related Topics

RTX API   Overview

Supported since or modified in @CHIP-RTOS version

    SC12SC13SC11SC1x3SC2x
    V1.00V1.00V1.00V0.90V1.00

This API List
List of C Libraries
@CHIP-RTOS Main Index


End of document