OS_DestroyThread

Syntax

#include <nitro/os.h>
void OS_DestroyThread( OSThread* thread );

Arguments

thread Ended thread

Return Values

None.

Description

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.

See Also

OS_InitThread, OS_ExitThread, OS_KillThread*, OS_SetThreadDestructor

Revision History

2005/07/12 Noted differences with OS_KillThread*().
2004/12/27 Initial version.


CONFIDENTIAL