www.beck-ipc.com

@CHIP-RTOS C Library - RTOS API


RTX_Kill_Task

Kill the specified task.   The killed task remains in the system and can be restarted.

int RTX_Kill_Task ( int taskID );

Parameters

taskID

Task handle returned from RTX_Create_Task or RTX_Create_Task_Without_Run.

Return Value

0, success
non-zero --> error code.

Comments

This function will force a ready, executing or suspended task to end.   All requests for task execution pending at the time of the kill request will be erased.

A task can kill itself.

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.

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