can_wup

ican_wup

Outline

Cancel task wakeup requests.

C format

 ER_UINT can_wup ( ID tskid );
 
 ER_UINT ican_wup ( ID tskid );


Assembly format

 MOV     A, #tskid
 CALL    !!_can_wup
 
 MOV     A, #tskid
 CALL    !!_ican_wup


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_OBJ

-41

Object state error (specified task is in the DORMANT state).

-

-

Normal completion (wakeup request count: positive value or 0).