T-Kernel Specification (1.B0.02)

4.5. EXTENDED SYNCHRONIZATION AND COMMUNICATION FUNCTIONS 111
tk del mtx
Delete Mutex
[C Language Interface]
ER ercd = tk_del_mtx ( ID mtxid ) ;
[Parameters]
ID mtxid Mutex ID
[Return Parameters]
ER ercd Error code
[Error Codes]
E OK
E ID
E NOEXS
Normal completion
Invalid ID number (mtxid is invalid or cannot be used)
Object does not exist (the mutex designated in mtxid does not exist)
[Description]
Deletes the mutex designated in mtxid.
Issuing this system call releases the mutex ID and control block memory space allocated to the mutex.
This system call completes normally even if there are tasks waiting to lock the deleted mutex, but error
code E DLT is returned to each of the tasks in WAIT state.
When a mutex is deleted, a task locking the mutex will have fewer locked mutexes. If the mutex was a
priority inheritance mutex or priority ceiling mutex, it is possible that the priority of the task locking
it will change as a result of its deletion.
Copyright c○ 2002, 2003 by T-Engine Forum
T-Kernel 1.B0.02