beautypg.com

Renesas Emulator System M3T-MR100 User Manual

Page 157

background image

- 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.