@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 tasks 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
|