Renesas M3T-MR100 - page 162

- 148 -
ref_mpl Reference variable-size memory pool status
iref_mpl Reference variable-size memory pool status
(handler only)
[
[[ [ C C L La an ng gu ua ag ge e A AP PI I ] ]] ]
ER ercd = ref_mpl( ID mplid, T_RMPL *pk_rmpl );
ER ercd = iref_mpl( ID mplid, T_RMPL *pk_rmpl );
z
z P Pa ar ra am me et te er rs s
ID mplid ID number of the target variable-size memory pool
T_RMPL *pk_rmpl Pointer to the packet to which variable-size memory pool status is returned
z
z R Re et tu ur rn n P Pa ar ra am me et te er rs s
ER ercd Terminated normally (E_OK)
T_RMPL *pk_rmpl Pointer to the packet to which variable-size memory pool status is returned
Contents of pk_rmpl
typedef struct t_rmpl{
ID wtskid +0 2 Task ID waiting for memory block to be acquired (unused)
SIZE fmplsz +4 4 Free memory size (in bytes)
UINT fblksz +8 4 Maximum size of memory that can be acquired immediately (in
bytes)
} T_RMPL;
[
[[ [ A As ss se em mb bl ly y l la an ng gu ua ag ge e A AP PI I ] ]] ]
.include mr100.inc
ref_mpl MPLID,PK_RMPL
iref_mpl MPLID,PK_RMPL
z
z P Pa ar ra am me et te er rs s
MPLID ID number of the target variable-size memory pool
PK_RMPL Poin ter to the packet to which variable-size memory pool status is returned
z
z R Re eg gi is st te er r c co on nt te en nt ts s a af ft te er r s se er rv vi ic ce e c ca al ll l i is s i is ss su ue ed d
Register name Content after service call is issued
R0 Error code
R2 ID number of the target variable-size memory pool
A1 Pointer to the packet to which variab le-size memory pool status is returned
[
[[ [ E Er rr ro or r c co od de e ] ]] ]
None
[
[[ [ F Fu un nc ct ti io on na al l d de es sc cr ri ip pt ti io on n ] ]] ]
This service call returns various statuses of the message buffer indicated by mplid.
 wtskid
Unused.
 fmplsz
A free memory size is returned.
 fblksz
The maximum size of memor y that can be acquired immediately is returned.
If this service call is to be issued from task context, use ref_mpl; if issued from non-task context, use iref_mpl.