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     Normal completion
E_ID     Invalid ID number (tskid is invalid or cannot be used)
E_NOEXS  Object does not exist (the task specified in tskid does not exist)
E_OBJ    Invalid object state (the task is not in DORMANT state)
[Description]

Starts the task specified in tskid.

This system call changes the state of the specified 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) specified 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.

[Porting Guideline]

Note that stacd is of INT type and the allowable range of values that can be specified may vary depending on the system.

Comments

Click here to Post a Comment