Everything

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
-
0 or more
Normal completion (wake-up request count).
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.
E_NOEXS
-42
Non-existent object.
- The task specified by tskid does not exist.