Renesas M3T-MR100 get_pri Reference task priority iget_pri Reference task priority(handler only)

- 77 -
get_pri Reference task priority
iget_pri Reference task priority(handler only)
[
[[ [ C C L La an ng gu ua ag ge e A AP PI I ] ]] ]
ER ercd = get_pri( ID tskid, PRI *p_tskpri );
ER ercd = iget_pri( ID tskid, PRI *p_tskpri );
z
z P Pa ar ra am me et te er rs s
ID tskid ID number of the target task
PRI *p_tskpri Pointer to the area to which task priority is returned
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
get_pri TSKID
iget_pri 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 Acquired task priority
[
[[ [ E Er rr ro or r c co od de e ] ]] ]
E_OBJ Object status invalid(task indicated by tskid is an inactive state)
[
[[ [ 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 returns the priority of the task indicated by tskid to the area indicated by p_tskpri. If TSK_SELF is speci-
fied, the priority of the issuing task itself is acquired. If TSK_SELF is specified for tskid in non-task context, operation of
the service call cannot be guaranteed.
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.
If this service call is to be issued from task context, use get_pri; if issued from non-task context, use iget_pri.