can_wup

ican_wup

Outline

Cancel task wake-up requests.

C format

 ER_UINT can_wup (ID tskid);

 ER_UINT ican_wup (ID tskid);

Parameter(s)

I/O	Parameter	Description
I	ID tskid;	ID number of the task. TSK_SELF: Invoking task. Value: ID number of the task.

Explanation

These service calls cancel all of the wake-up requests queued to the task specified by parameter tskid (the wake-up request counter is set to 0), and return the number of cancelled wake-up requests.

Return value

Macro	Value	Description
E_ID	-18	Invalid ID number. - tskid < 0 - tskid > VTMAX_TSK - When this service call was issued from a non-task, TSK_SELF was specified for tskid.
E_CTX	-25	Context error. - This service call was issued in the CPU locked state. - This service call was issued in the status PSW.IPL > kernel interrupt mask level. Note When the ican_wup is issued from task or the can_wup is issued from non-task, the context error is not detected and normal operation of the system is not guaranteed.
E_OBJ	-41	Object state error. - Specified task is in the DORMANT state.
-	0 or more	Normal completion (wake-up request count).