T-Kernel Specification (1.B0.02)

150 CHAPTER 4. T-KERNEL/OS FUNCTIONS
tk del mpf
Delete Fixed-size Memory Pool
[C Language Interface]
ER ercd = tk_del_mpf ( ID mpfid ) ;
[Parameters]
ID mpfid Fixed-size memory pool ID
[Return Parameters]
ER ercd Error code
[Error Codes]
E OK
E ID
E NOEXS
Normal completion
Invalid ID number (mpfid is invalid or cannot be used)
Object does not exist (the fixed-size memory pool designated in mpfid does not exist)
[Description]
Deletes the fixed-size memory pool designated in mpfid.
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