Renesas M3T-MR100 sus_tsk Suspend task isus_tsk Suspend task (handler only)

- 94 -
sus_tsk Suspend task
isus_tsk Suspend task (handler only)
[
[[ [ C C L La an ng gu ua ag ge e A AP PI I ] ]] ]
ER ercd = sus_tsk( ID tskid );
ER ercd = isus_tsk( ID tskid );
z
z P Pa ar ra am me et te er rs s
ID tskid ID number of the target task
z
z R Re et tu ur rn n P Pa ar ra am me et te er rs s
ER ercd Terminated normally (E_OK) or error code
[
[[ [ A As ss se em mb bl ly y l la an ng gu ua ag ge e A AP PI I ] ]] ]
.include mr100.inc
sus_tsk TSKID
isus_tsk TSKID
z
z P Pa ar ra am me et te er rs s
TSKID ID number of the target task
z
z R Re eg gi is st te er r c co on nt te en nt ts s a af ft te er r s se er rv vi ic ce e c ca al ll l i is s i is ss su ue ed d
Register name Content after service call is issued
R0 Error code
R2 ID number of the target task
[
[[ [ E Er rr ro or r c co od de e ] ]] ]
E_OBJ Object status invalid(task indicated by tskid is an inactive state)
E_QOVR Queuing overflow
[
[[ [ F Fu un nc ct ti io on na al l d de es sc cr ri ip pt ti io on 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.