Development Tools

get_tid

Outline

Reference task ID in the RUNNING state.

C format

 ER      get_tid (ID *p_tskid);

 ER      iget_tid (ID *p_tskid);

Parameter(s)


I/O	Parameter	Description
O	ID *p_tskid;	Pointer to the area returning the task ID number.

Explanation

These service calls store the ID of a task in the RUNNING state in the area specified by parameter p_tskid.

This service call stores TSK_NONE in the area specified by parameter p_tskid if no tasks that have entered the RUNNING state exist.

Return value


Macro	Value	Description
E_OK	0	Normal completion.
E_PAR	-17	Parameter error. - p_tskid == NULL
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_tid is issued from task or the get_tid is issued from non-task, the context error is not detected and normal operation of the system is not guaranteed.
E_MACV	-26	Memory access violation. (only for get_tid) - The operand-write access to the area indicated by p_tskid has not been permitted to the invoking task.