vrst_mpf

Outline

Reset fixed-sized memory pool.

C format

 ER      vrst_mpf (ID mpfid);

Parameter(s)

I/O	Parameter	Description
I	ID mpfid;	ID number of the fixed-sized memory pool.

Explanation

This service call reset the fixed-sized memory pool specified by parameter mpfid.

The tasks to wait to get memory block from the target fixed-sized memory pool are released from the WAITING state, and EV_RST is returned as a return value for the tasks.

Note 1 All fixed-sized memory blocks that had already been acquired are returned to the target fixed-sized memory pool. Therefore, do not access those fixed-sized memory blocks after issuing this service call.

Note 2 This service call is the function outside mITRON4.0 specification.

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 from a non-task. - This service call was issued in the CPU locked state. - 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_NOEXS	-42	Non-existent object. - The fixed-sized memory pool specified by mpfid does not exist.