Development Tools

ref_mpf

iref_mpf

Outline

Reference fixed-sized memory pool state.

C format

 ER      ref_mpf (ID mpfid, T_RMPF *pk_rmpf);

 ER      iref_mpf (ID mpfid, T_RMPF *pk_rmpf);

Parameter(s)


I/O	Parameter	Description
I	ID mpfid;	ID number of the fixed-sized memory pool to be referenced.
O	T_RMPF *pk_rmpf;	Pointer to the packet returning the fixed-sized memory pool state.

[Fixed-sized memory pool state packet: T_RMPF]


typedef struct t_rmpf { ID wtskid; /Existence of waiting task/ UINT fblkcnt; /Number of free memory blocks/ ATR mpfatr; /Attribute/ ID memid; /Reserved for future use/ } T_RMPF;

Explanation

Stores fixed-sized memory pool state packet (ID number of the task at the head of the wait queue, number of free memory blocks, etc.) of the fixed-sized memory pool specified by parameter mpfid in the area specified by parameter pk_rmpf.

Note For details about the fixed-sized memory pool state packet, refer to "15.2.9 Fixed-sized memory pool state packet".

Return value


Macro	Value	Description
E_OK	0	Normal completion.
E_ID	-18	Invalid ID number. - mpfid < 0x0 - mpfid > Maximum ID number
E_CTX	-25	Context error. - This service call was issued in the CPU locked state.
E_NOEXS	-42	Non-existent object. - Specified fixed-sized memory pool is not registered.