#include <nitro/os.h>
void OS_DestroyThread( OSThread* thread );
thread | Ended thread |
None.
Ends the specified thread. Then switches to another executable thread.
With OS_DestroyThread()
, a destructor function is not called even if a thread destructor has been preset using OS_SetThreadDestructor()
.(The destructor function is called by OS_KillThread*()
.)
It is also possible to specify the current thread for thread. If this is done, the thread kills itself and switches to the next executable thread. Even in this case, the thread destructor is not called.
If the mutex for thread is locked, all locked mutex unlock.
Be cautious when using OS_DestroyThread()
--it suddenly terminates the specified thread thread without any advance warning. If you are going to use this function, be sure you understand the operations of threads.
OS_InitThread, OS_ExitThread, OS_KillThread*, OS_SetThreadDestructor
2005/07/12 Noted differences with OS_KillThread*()
.
2004/12/27 Initial version.
CONFIDENTIAL