Renesas Emulator System M3T-MR100, Руководство пользователя

Страница: 108 / 306

- 92 -
rel_wai Release task from waiting
irel_wai Release task from waiting (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 = rel_wai( ID tskid );
ER ercd = irel_wai( 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
rel_wai TSKID
irel_wai 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 not an wait 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 forcibly release the task indicated by tskid from waiting (except SUSPENDED state) to place it into
READY or RUNNING state. The forcibly released task returns the error code E_RLWAI. If the target task has been en-
queued in some waiting queue, the task is dequeued from it by execution of this service call.
If this service call is issued to a task in WAITING-SUSPENDED state, the target task is released from WAITING state and
goes to SUSPENDED state.
34
If the target task is not in WAITING state, the error code E_OBJ 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 rel_wai; if issued from non-task context, use irel_wai.
34
This means that tasks cannot be resumed from SUSPENDED state by this service call. Only the rsm_tsk, irsm_tsk, frsm_tsk, and
ifrsm_tsk service calls can release them from SUSPENDED state.