rel_wai

irel_wai

概要

WAITING状態の強制解除

C言語形式

 ER      rel_wai ( ID tskid );
 
 ER      irel_wai ( ID tskid );
 

アセンブリ言語形式

 MOV     A, #tskid
 CALL    !!_rel_wai
 
 MOV     A, #tskid
 CALL    !!_irel_wai
 

パラメータ

I/O

パラメータ

説明

I

 ID      tskid;
タスクのID

 

機能

tskidで指定されたタスクのWAITING状態を強制的に解除します。

これにより,対象タスクは待ちキューから外れ,WAITING状態からREADY状態へ,またはWAITING-SUSPENDED状態からSUSPENDED状態へと遷移します。

なお,本サービス・コールの発行によりWAITING状態を解除されたタスクには,WAITING状態へと遷移するきっかけとなったサービス・コール(slp_tskwai_semなど)の戻り値として“E_RLWAI”が返されます。

備考1 本サービス・コールを発行した際,対象タスクがREADY状態へと遷移する場合は,該当タスクの優先度に対応したレディ・キューの最後尾にキューイングし直す処理もあわせて実行されます。

備考2 本サービス・コールでは,強制解除要求のキューイングが行われません。このため,対象タスクがWAITING状態,またはWAITING-SUSPENDED状態以外の場合には,戻り値として“E_OBJ”が返されます。

戻り値

マクロ

数値

意味

E_OK

0

正常終了

E_OBJ

-41

対象タスクがWAITING状態,またはWAITING-SUSPENDED状態でない