IPC@CHIP® RTOS-PPC – API Documentation
The execution of specified task is stopped and the task is placed back at its start gate. The task remains present in the system awaiting a trigger.
This API is nearly the same as RTX_End_Task(). The difference is that this API will erase any trigger counts that were pending so that the task will not restart immediately due to stored triggers.
A task can kill itself.
The system will not kill a task which is inside an @CHIP-RTOS-PPC system call until that task has reached the return point from the system call. Exceptions to this rule are the RTX functions which block, such as RTX_Sleep_Request(), RTX_Sem_Wait() and so on for which the system will automatically remove the wait condition so that the task kill action occurs immediately. If a task was waiting on a TCP/IP socket, closing the socket would allow the task kill action to complete.
If the task being killed was waiting on a kernel object (semaphore, Event Group or Message Exchange), it will automatically be removed from that objects wait queue by this API. Any resource semaphores that where owned by this task being killed will be automatically freed by the system. (Note that the status of any counting semaphores has no association to a task by which the system could automatically "release" ownership.)
This API may be called from inside an RTX ISR.