T-Kernel Specification (1.B0.02)

6.1. KERNEL INTERNAL STATE ACQUISITION FUNCTIONS 263
td ref tsk
Reference Task State
[C Language Interface]
ER ercd = td_ref_tsk ( ID tskid, TD_RTSK *rtsk );
[Parameters]
ID tskid Task ID (TSK SELF can be designated)
TD RTSK rtsk Packet address for returning the task state
[Return Parameters]
ER ercd Error code
[Error Codes]
E OK
E ID
E NOEXS
Normal completion
Bad identifier
Object does not exist
[Description]
Gets the state of the task designated in tskid. This function is similar to tk ref tsk, with the task
start address and stack information added to the state information obtained.
typedef struct td_rtsk {
VP exinf; /* extended information */
PRI tskpri; /* current priority */
PRI tskbpri; /* base priority */
UINT tskstat; /* task state */
UINT tskwait; /* wait factor */
ID wid; /* waiting object ID */
INT wupcnt; /* queued wakeup request count */
INT suscnt; /* SUSPEND request nesting count */
RELTIM slicetime; /* maximum continuous run time (ms) */
UINT waitmask; /* masked wait factors */
UINT texmask; /* allowed task exceptions */
UINT tskevent; /* raised task event */
FP task; /* task start address */
INT stksz; /* user stack size (in bytes) */
INT sstksz; /* system stack size (in bytes) */
VP istack; /* user stack pointer initial value */
VP isstack; /* system stack pointer initial value */
} TD_RTSK;
Copyright c○ 2002, 2003 by T-Engine Forum
T-Kernel 1.B0.02