Development Tools

get_pri

Outline

Reference task 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 to reference. TSK_SELF: Invoking task. Value: ID number of the task to reference.
O	PRI *p_tskpri;	Current priority of specified task.

Explanation

Stores current priority of the task specified by parameter tskid in the area specified by parameter p_tskpri.

Return value


Macro	Value	Description
E_OK	0	Normal completion.
E_ID	-18	Invalid ID number. - tskid < 0x0 - tskid > Maximum ID number - When this service call was issued from a non-task, TSK_SELF was specified tskid.
E_CTX	-25	Context error. - This service call was issued in the CPU locked state.
E_OBJ	-41	Object state error. - Specified task is in the DORMANT state.
E_NOEXS	-42	Non-existent object. - Specified task is not registered.