Renesas M3T-MR100 Network Card User Manual


 
- 73 -
ter_tsk Terminate task
[
[
[
[
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 = ter_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 forcibly terminated 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
ter_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 forcibly terminated 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_ILUSE Service call improperly used task indicated by tskid is the issuing task itself)
[
[
[
[
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 terminates the task indicated by tskid. If the activation request count of the target task is equal to or greater
than 1, the activation request count is decremented by 1, and processing similar to that of act_tsk or iact_tsk is performed.
In that case, the task is placed from DORMANT state into READY state. The task has its extended information passed to it
as parameter when the task starts up.
If a task specifies its own task ID or TSK_SELF, an E_ILUSE error is returned.
If the specified task was placed into WAITING state and has been enqueued in some waiting queue, the task is dequeued
from it by execution of this service call. However, the semaphore and other resources the specified task had acquired pre-
viously are not released.
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.
This service call can only be used in task context, and cannot be used in non-task context.