ter_tsk

概要

他タスクの強制終了

C言語形式

 ER      ter_tsk ( ID tskid );
 

アセンブリ言語形式

 MOV     A, #tskid
 CALL    !!_ter_tsk
 

パラメータ

I/O

パラメータ

説明

I

 ID      tskid;
タスクのID

 

機能

tskidで指定されたタスクを強制的にDORMANT状態へと遷移させます。

これにより,対象タスクは,RI78V4のスケジューリング対象から除外されます。

ただし,本サービス・コールを発行した際,対象タスクに起動要求がキューイングされていた(起動要求カウンタが0x0以外であった)場合には,DORMANT状態への状態操作処理,および,起床要求カウンタの減算処理(起床要求カウンタから0x1を減算)を行ったのち,DORMANT状態からREADY状態への状態操作処理もあわせて実行されます。

備考1 本サービス・コールでは,対象タスクがsig_semget_mpfなどの発行により獲得したOS資源の返却は行いません。したがって,獲得中のOS資源については,本サービス・コールを発行する以前に返却する必要があります。

備考2 本サービス・コールでは,DORMANT状態への状態操作処理を実行する際に,

- 優先度(現在優先度)

- 起床要求数

- サスペンド要求数

- 割り込み状態

といった情報をタスクの生成時に設定される値で初期化しています。

戻り値

マクロ

数値

意味

E_OK

0

正常終了

E_OBJ

-41

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