T-Kernel Specification (1.B0.02)

158 CHAPTER 4. T-KERNEL/OS FUNCTIONS
tk del mpl
Delete Variable-size Memory Pool
[C Language Interface]
ER ercd = tk_del_mpl ( ID mplid ) ;
[Parameters]
ID mplid Variable-size memory pool ID
[Return Parameters]
ER ercd Error code
[Error Codes]
E OK
E ID
E NOEXS
Normal completion
Invalid ID number (mplid is invalid or cannot be used)
Object does not exist (the variable-size memory pool designated in mplid does not exist)
[Description]
Deletes the variable-size memory pool designated in mplid.
No check or notification is made as to whether there are tasks using memory allocated from this memory
pool. The system call completes normally even if not all blocks have been returned to the pool.
Issuing this system call releases the memory pool ID number, the control block memory space and the
memory pool space itself.
This system call completes normally even if there are tasks waiting for memory block allocation from
the deleted memory pool, but error code E DLT is returned to the tasks in WAIT state.
Copyright c○ 2002, 2003 by T-Engine Forum
T-Kernel 1.B0.02