-
ref_tsk
iref_tsk
-
ER ref_tsk (ID tskid, T_RTSK *pk_rtsk);
ER iref_tsk (ID tskid, T_RTSK *pk_rtsk);
|
|
|
|
ID tskid;
|
Value: ID number of the task.
|
|
T_RTSK *pk_rtsk;
|
Pointer to the packet returning the task state.
|
[Task state packet: T_RTSK]
typedef struct t_rtsk {
STAT tskstat; /*Current state*/
PRI tskpri; /*Current priority*/
PRI tskbpri; /*Base priority*/
STAT tskwait; /*Reason for waiting*/
ID wobjid; /*Object ID number for which the task is waiting*/
TMO lefttmo; /*Remaining time until time-out*/
UINT actcnt; /*Activation request count*/
UINT wupcnt; /*Wake-up request count*/
UINT suscnt; /*Suspension count*/
} T_RTSK;
|
Stores task state packet (current state, current priority, etc.) of the task specified by parameter
tskid in the area specified by parameter
pk_rtsk.
-
tskstat
Stores the current state.
-
tskpri
Stores the current priority.
The
tskpri is effective only when the
tskstat is other than TTS_DMT.
-
tskbpri
Stores the base priority.
The
tskbpri is effective only when the
tskstat is other than TTS_DMT.
-
tskwait
Stores the reason for waiting.
The
tskwait is effective only when the
tskstat is TTS_WAI or TTS_WAS.
-
wobjid
Stores the object (such as semaphore, eventflag, etc.) ID number for which the task waiting.
The
wobjid is effective only when the
tskwait is TTW_SEM or TTW_FLG or TTW_SDTQ or TTW_RDTQ or TTW_MBX or TTW_MTX or TTW_SMBF or TTW_RMBF or TTW_MPF or TTW_MPL.
-
lefttmo
Stores the remaining time until time-out (in millisecond).
The
TMO_FEVR is stored for waiting forever.
The
lefttmo is effective only when the
tskstat is TTS_WAI or TTS_WAS, and the
tskwait is other than TTW_DLY.
Note The
lefttmo is undefined when the
tskwait is TTW_DLY.
-
actcnt
Stores the activation request count.
-
wupcnt
Stores the wake-up request count.
The
wupcnt is effective only when the tskstat is other than TTS_DMT.
-
suscnt
Stores the suspension count.
The
suscnt is effective only when the tskstat is other than TTS_DMT.
|
|
|
|
|
|
|
|
- When this service call was issued from a non-task, TSK_SELF was specified for tskid.
|
|
|
- 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 iref_tsk is issued from task or the ref_tsk is issued from non-task, the context error is not detected and normal operation of the system is not guaranteed.
|