del_mpl

Outline

Delete variable-sized memory pool.

C format

 ER      del_mpl (ID mplid);

Parameter(s)

I/O	Parameter	Description
I	ID mplid;	ID number of the variable-sized memory pool.

Explanation

This service call can be called from tasks that belong to Trusted Domain.

This service call deletes the variable-sized memory pool indicated by mplid.

When there are waiting tasks for the target variable-sized memory pool by using get_mpl or tget_mpl, this service call cancels the WAITING state of the tasks and returns E_DLT as a return value of the get_mpl or tget_mpl.

Return value

Macro	Value	Description
E_OK	0	Normal completion.
E_ID	-18	Invalid ID number. - mplid < 0 - mplid > VTMAX_MPL
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 variable-sized memory pool specified by mplid does not exist.