www.beck-ipc.com

@CHIP-RTOS C Library V2.00 - 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 messages in the task’s mailboxes at the time of the kill request will be flushed.   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, or is about to wait for a resource or counting semaphore.

See Also

RTOS API

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


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


End of document