beautypg.com

Renesas Emulator System M3T-MR100 User Manual

Page 93

background image

- 77 -

get_pri

Reference task priority

iget_pri

Reference task priority(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 = get_pri( ID tskid, PRI *p_tskpri );
ER ercd = iget_pri( ID tskid, PRI *p_tskpri );

z

z

P

P

a

a

r

r

a

a

m

m

e

e

t

t

e

e

r

r

s

s

ID

tskid

ID number of the target task

PRI

*p_tskpri

Pointer to the area to which task priority 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) or error code

[

[

[

[

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
get_pri TSKID
iget_pri TSKID

z

z

P

P

a

a

r

r

a

a

m

m

e

e

t

t

e

e

r

r

s

s

TSKID

ID number of the target task

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 Acquired

task

priority

[

[

[

[

E

E

r

r

r

r

o

o

r

r

c

c

o

o

d

d

e

e

]

]

]

]

E_OBJ

Object status invalid(task indicated by tskid is an inactive state)

[

[

[

[

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 the priority of the task indicated by tskid to the area indicated by p_tskpri. If TSK_SELF is speci-
fied, the priority of the issuing task itself is acquired. If TSK_SELF is specified for tskid in non-task context, operation of
the service call cannot be guaranteed.

If the task indicated by tskid is in DORMANT state, it returns the error code E_OBJ as a return value for the service call.

If this service call is to be issued from task context, use get_pri; if issued from non-task context, use iget_pri.