Development Tools

frsm_tsk

ifrsm_tsk

Outline

Forcibly resume suspended task.

C format


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

Assembly format


MOV A, #tskid CALL !!_frsm_tsk MOV A, #tskid CALL !!_ifrsm_tsk

Parameter(s)


I/O	Parameter	Description
I	ID tskid;	ID number of the task to be resumed.

Explanation

These service calls set the suspend request counter for the task specified by parameter tskid to 0x1 f, and then forcibly cancel the SUSPENDED state of the target task.

As a result, the target task is moved from the SUSPENDED state to the READY state, or from the WAITING-SUSPENDED state to the WAITING state.

Note 1 If the target task is moved to the READY state after this service call is issued, this service call also re-queues the task at the end of the ready queue corresponding to the priority of the task.

Note 2 This service call does not perform queuing of forced 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_OBJ	-41	Object state error (specified task is neither in the SUSPENDED state nor WAITING-SUSPENDED state).