wup_tsk

iwup_tsk

概要

タスクの起床

C言語形式

 ER      wup_tsk ( ID tskid );
 ER      iwup_tsk ( ID tskid );


パラメータ

I/O

パラメータ

説明

I

 ID      tskid;
タスクのID

TSK_SELF: 自タスク

数値: タスクのID



機能

tskidで指定されたタスクをWAITING状態(起床待ち状態)からREADY状態へ,またはWAITING-SUSPENDED状態からSUSPENDED状態へと遷移させます。

ただし,本サービス・コールを発行した際,対象タスクが起床待ち状態以外の場合には,状態操作処理は行わず,起床要求カウンタに0x1を加算します。

備考 RI850V4が管理する起床要求カウンタは,7ビット幅で構成されています。このため,本サービス・コールでは,起床要求数が127回を越えるような場合には,起床要求のキューイング(起床要求カウンタの加算処理)は行わず,戻り値としてE_QOVRを返します。

戻り値

マクロ

数値

意味

E_OK

0

正常終了

E_ID

-18

IDの指定が不正である

- tskid<0x0

- tskid>生成されているタスクの最大ID

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

E_CTX

-25

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

E_OBJ

-41

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

E_NOEXS

-42

対象タスクが生成されていない

E_QOVR

-43

起床要求数が127回を越えた