Everything

del_mpf

Outline
Delete fixed-sized memory pool.
C format
 ER      del_mpf (ID mpfid);
Parameter(s)
I/O
Parameter
Description
I
 ID      mpfid;
ID number of the fixed-sized memory pool.

Explanation
This service call can be called from tasks that belong to Trusted Domain.
This service call deletes the fixed-sized memory pool indicated by mpfid.
When there are waiting tasks for the target fixed-sized memory pool by using get_mpf or tget_mpf, this service call cancels the WAITING state of the tasks and returns E_DLT as a return value of the get_mpf or tget_mpf.
Return value
Macro
Value
Description
E_OK
0
Normal completion.
E_ID
-18
Invalid ID number.
- mpfid < 0
- mpfid > VTMAX_MPF
E_CTX
-25
Context error.
- This service call was issued in the CPU locked state.
- This service call was issued from non-task.
- This service call was issued in the status "PSW.IPL > kernel interrupt mask level".
E_MACV
-26
Memory access violation.
- Stack pointer points out of user stack for invoking task.
E_OACV
-27
Object access violation.
- The invoking task does not belong to trusted domain.
E_NOEXS
-42
Non-existent object.
- The fixed-sized memory pool specified by mpfid does not exist.