frsm_tsk

ifrsm_tsk

Outline

Forcibly resume suspended task.

C format

 ER      frsm_tsk (ID tskid);
 ER      ifrsm_tsk (ID tskid);
Parameter(s)

I/O

Parameter

Description

I

 ID      tskid;
ID number of the task to be resumed.



Explanation

These service calls cancel all of the suspend requests issued for the task specified by parameter tskid (by setting the suspend request counter to 0x0). As a result, the target task moves from the SUSPENDED state to the READY state, or from the WAITING-SUSPENDED state to the WAITING state.

Note This service call does not perform queuing of cancellation requests. If the target task is in a state other than the SUSPENDED or WAITING-SUSPENDED state, "E_OBJ" is therefore returned.

Return value

Macro

Value

Description

E_OK

0

Normal completion.

E_ID

-18

Invalid ID number.

- tskid < 0x0

- tskid > Maximum ID number

E_CTX

-25

Context error.

- This service call was issued in the CPU locked state.

E_OBJ

-41

Object state error.

- Specified task is neither in the SUSPENDED state nor WAITING-SUSPENDED state.

E_NOEXS

-42

Non-existent object.

- Specified task is not registered.