Renesas M3T-MR100 can_act Cancel task activation request ican_act Cancel task activation request (handler only)

- 67 -
can_act Cancel task activation request
ican_act Cancel task activation request (handler only)
[
[[ [ C C L La an ng gu ua ag ge e A AP PI I ] ]] ]
ER_UINT actcnt = can_act( ID tskid );
ER_UINT actcnt = ican_act( ID tskid );
z
z P Pa ar ra am me et te er rs s
ID tskid
ID number of the task to cancel
z
z R Re et tu ur rn n P Pa ar ra am me et te er rs s
ER_UINT actcnt > 0 Canceled activation request count
actcnt < 0 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
can_act TSKID
ican_act TSKID
z
z P Pa ar ra am me et te er rs s
TSKID ID number of the task to cancel
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
R2R0 Canceled startup request count or error code
[
[[ [ E Er rr ro or r c co od de e ] ]] ]
None
[
[[ [ 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 finds the number of task activation requests enqueued for the task indicated by tskid, returns the result as a
return parameter, and at the same time invalidates all of the task’s activation requests.
Specifying tskid=TSK_SELF(0) specifies the issuing task itself. If TSK_SELF is specified for tskid in non-task context,
operation of this service call cannot be guaranteed.
This service call can be invoked for a task in DORMANT state as the target task. In that case, the return parameter is 0.
If this service call is to be issued from task context, use can_act; if issued from non-task context, use ican_act.