Renesas Emulator System M3T-MR100, User Manual

Page: 157 / 306

- 141 -
ref_mpf Reference fixed-size memory pool status
iref_mpf Reference fixed-size memory pool status
(handler only)
[
[
[
[
C
C
L
L
a
a
n
n
g
g
u
u
a
a
g
g
e
e
A
A
P
P
I
I
]
]
]
]
ER ercd = ref_mpf( ID mpfid, T_RMPF *pk_rmpf );
ER ercd = iref_mpf( ID mpfid, T_RMPF *pk_rmpf );
z
z
P P a a r r a a m m e e t t e e r r s s
ID mpfid Task ID waiting for memory block to be acquired
T_RMPF *pk_rmpf Pointer to the packet to which fixed-size memory pool status is returned
z z
R
R
e
e
t
t
u
u
r
r
n
n
P
P
a
a
r
r
a
a
m
m
e
e
t
t
e
e
r
r
s
s
ER ercd Terminated normally (E_OK)
T_RMPF *pk_rmpf Pointer to the packet to which fixed-size memory pool status is returned
Contents of pk_rmpf
typedef struct
t_rmpf{
ID wtskid +0 2 Task ID waiting for memory block to be acquired
UINT fblkcnt +2 4 Number of free memory blocks
} T_RMPF;
[
[
[
[
A
A
s
s
s
s
e
e
m
m
b
b
l
l
y
y
l
l
a
a
n
n
g
g
u
u
a
a
g
g
e
e
A
A
P
P
I
I
]
]
]
]
.include mr100.inc
ref_mpf MPFID,PK_RMPF
iref_mpf MPFID,PK_RMPF
z
z
P P a a r r a a m m e e t t e e r r s s
MPFID Task ID waiting for memory block to be acquired
PK_RMPF Pointer to the packet to which fixed-size memory pool status is returned
z z
R
R
e
e
g
g
i
i
s
s
t
t
e
e
r
r
c
c
o
o
n
n
t
t
e
e
n
n
t
t
s
s
a
a
f
f
t
t
e
e
r
r
s
s
e
e
r
r
v
v
i
i
c
c
e
e
c
c
a
a
l
l
l
l
i
i
s
s
i
i
s
s
s
s
u
u
e
e
d
d
Register name Content after service call is issued
R0 Error code
R2 Task ID waiting for memory block to be acquired
A1 Pointer to the packet to which fixed-size memory pool status is returned
[
[
[
[
E
E
r
r
r
r
o
o
r
r
c
c
o
o
d
d
e
e
]
]
]
]
None
[ [ [ [ F F u u n n c c t t i i o o n n a a l l d d e e s s c c r r i i p p t t i i o o n n ] ] ] ]
This service call returns various statuses of the message buffer indicated by mpfid.
‹
wtskid
Returned to wtskid is the ID number of the task at the top of a memory block waiting queue (the first queued
task). If no tasks are kept waiting, TSK_NONE is returned.
‹
fblkcnt
The number of free memory blocks in the specified memory pool is returned.
If this service call is to be issued from task context, use rel_mpf; if issued from non-task context, use irel_mpf.