can_wup

ican_wup

概要

起床要求の解除

C言語形式

 ER_UINT can_wup ( ID tskid );
 ER_UINT ican_wup ( ID tskid );
パラメータ

I/O

パラメータ

説明

I

 ID      tskid;
タスクのID

TSK_SELF: 自タスク

数値: タスクのID



機能

tskidで指定されたタスクにキューイングされている起床要求をすべて解除(起床要求カウンタに0を設定)し,戻り値として解除した起床要求数を返します。

戻り値

マクロ

数値

意味



0以上

正常終了(解除した起床要求数)

E_ID

-18

不正ID番号

- tskid < 0

- tskid > VTMAX_TSK

- 非タスクから本サービス・コールを発行した際,tskidTSK_SELFを指定した。

E_CTX

-25

コンテキスト・エラー

- CPUロック状態から本サービス・コールを発行した。

- 「PSW.IPL > カーネル割り込みマスクレベル」の状態から本サービス・コールを発行した。

備考 タスクからican_wupを発行した場合,および非タスクからcan_wupを発行した場合,コンテキスト・エラーは検出されず,システムの正常な動作は保証されません。

E_OBJ

-41

オブジェクト状態エラー

- 対象タスクがDORMANT状態である。

E_NOEXS

-42

オブジェクト未生成

- tskidのタスクが存在しない。