beautypg.com

Renesas Emulator System M3T-MR100 User Manual

Page 110

background image

- 94 -

sus_tsk Suspend

task

isus_tsk

Suspend task (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 = sus_tsk( ID tskid );
ER ercd = isus_tsk( ID tskid );

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

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
sus_tsk TSKID
isus_tsk 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

ID number of the target task

[

[

[

[

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)

E_QOVR Queuing

overflow

[

[

[

[

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 aborts execution of the task indicated by tskid and places it into SUSPENDED state. Tasks are resumed
from this SUSPENDED state by the rsm_tsk, irsm_tsk, frsm_tsk, or ifrsm_tsk service call. 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.

The maximum number of suspension requests by this service call that can be nested is 1. If this service call is issued to a
task which is already in SUSPENDED state, the error code E_QOVR is returned.

This service call forbids specifying the issuing task itself for tskid.

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