can_wup

ican_wup

Outline

Cancel task wakeup 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 for cancelling wakeup requests.

TSK_SELF: Invoking task.

Value: ID number of the task for cancelling wakeup requests.



Explanation

These service calls cancel all of the wakeup requests queued to the task specified by parameter tskid (the wakeup request counter is set to 0x0).

When this service call is terminated normally, the number of cancelled wakeup requests is returned.

Return value

Macro

Value

Description

E_ID

-18

Invalid ID number.

- tskid < 0x0

- tskid > Maximum ID number

- When this service call was issued from a non-task, TSK_SELF was specified tskid.

E_CTX

-25

Context error.

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

E_OBJ

-41

Object state error.

- Specified task is in the DORMANT state.

E_NOEXS

-42

Non-existent object.

- Specified task is not registered.

other

-

Normal completion (wakeup request count).