T-Kernel Specification (1.B0.02)

50 CHAPTER 4. T-KERNEL/OS FUNCTIONS
tk ref tsk
Reference Task Status
[C Language Interface]
ER ercd = tk_ref_tsk ( ID tskid, T_RTSK *pk_rtsk ) ;
[Parameters]
ID tskid Task ID
T RTSK* pk rtsk Address of packet for returning task status
[Return Parameters]
ER ercd Error code
pk rtsk detail:
VP exinf Extended information
PRI tskpri Current task priority
PRI tskbpri Base priority
UINT tskstat Task state
UINT tskwait Wait factor
ID wid Waiting object ID
INT wupcnt Queued wakeup requests
INT suscnt Nested suspend requests
RELTIM slicetime Maximum continuous run time allowed (ms)
UINT waitmask Disabled wait factors
UINT texmask Allowed task exceptions
UINT tskevent Task events
(Other implementation-dependent parameters may be added beyond this point.)
[Error Codes]
E OK
E ID
E NOEXS
E PAR
Normal completione
Invalid ID number (tskid is invalid or cannot be used)
Object does not exist (the task designated in tskid does not exist)
Parameter error (the return parameter packet address cannot be used)
[Description]
Gets the state of the task designated in tskid.
tskstat takes the following values.
Copyright c○ 2002, 2003 by T-Engine Forum
T-Kernel 1.B0.02