T-Kernel Specification (1.B0.02)

32 CHAPTER 4. T-KERNEL/OS FUNCTIONS
tk sta tsk
Start Task
[C Language Interface]
ER ercd = tk_sta_tsk ( ID tskid, INT stacd ) ;
[Parameters]
ID tskid Task ID
INT stacd Task start code
[Return Parameters]
ER ercd Error code
[Error Codes]
E OK
E ID
E NOEXS
E OBJ
Normal completion
Invalid ID number (tskid is invalid or cannot be used)
Object does not exist (the task designated in tskid does not exist)
Invalid object state (the task is not in DORMANT state)
[Description]
Starts the task designated in tskid.
This system call changes the state of the designated task from DORMANT state to READY state.
Parameters to be passed to the task when it starts can be set in stacd. These parameters can be
referred to from the started task, enabling use of this feature for simple message passing.
The task priority when it starts is the task startup priority (itskpri) designated when the started task
was created.
Start requests by this system call are not queued. If this system call is issued while the target task is in
a state other than DORMANT state, the system call is ignored and error code E OBJ is returned to the
calling task.
Copyright c○ 2002, 2003 by T-Engine Forum
T-Kernel 1.B0.02