get_pri

iget_pri

Outline

Reference task current priority.

C format

 ER      get_pri (ID tskid, PRI *p_tskpri);
 ER      iget_pri (ID tskid, PRI *p_tskpri);
Parameter(s)

I/O

Parameter

Description

I

 ID      tskid;
ID number of the task.

TSK_SELF: Invoking task.

Value: ID number of the task.

O

 PRI     *p_tskpri;
Pointer to the area returning the current priority of the task.



Explanation

This service call stores the current priority of the task specified by parameter tskid in the area specified by parameter p_tskpri.

Note For current priority and base priority, refer to "6.2.2 Current priority and base priority".

Return value

Macro

Value

Description

E_OK

0

Normal completion.

E_ID

-18

Invalid ID number.

- tskid < 0

- tskid > VTMAX_TSK

- When this service call was issued from a non-task, TSK_SELF was specified for tskid.

E_CTX

-25

Context error.

- This service call was issued in the CPU locked state.

- This service call was issued in the status "PSW.IPL > kernel interrupt mask level".

Note When the iget_pri is issued from task or the get_pri is issued from non-task, the context error is not detected and normal operation of the system is not guaranteed.

E_OBJ

-41

Object state error.

- Specified task is in the DORMANT state.