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.