Everything

unl_mtx

概要
ミューテックスのロック解除
C言語形式
 ER      unl_mtx ( ID mtxid );
パラメータ
I/O
パラメータ
説明
I
 ID      mtxid;
ミューテックスのID

機能
mtxidで指定されたミューテックスのロック状態を解除します。その結果,自タスクがロックしているミューテックスがなくなった場合には,自タスクの現在優先度をベース優先度に変更します。
本サービス・コールを発行した際,対象ミューテックスの待ちキューにタスクがキューイングされていた場合には,ミューテックスのロック解除処理後,ただちに該当タスク(待ちキューの先頭タスク)によるミューテックスのロック処理が行われます。このとき,該当タスクは,待ちキューから外れ,WAITING状態(ミューテックス待ち状態)からREADY状態へ,またはWAITING-SUSPENDED状態からSUSPENDED状態へと遷移します。また,該当タスクの現在優先度を対象ミューテックスの上限優先度に変更します。ただし,該当タスクがすでに他のミューテックスをロックしており,かつ対象ミューテックスの上限優先度がロック済みのミューテックスの上限優先度以下の場合は,該当タスクの現在優先度は変更しません。
備考1 ミューテックスのロック解除が可能なタスクは“対象ミューテックスをロックしたタスク”に限られます。このため,自タスクがロックしていないミューテックスに対して本サービス・コールを発行した場合には,戻り値としてE_ILUSEを返します。
備考2 タスクの終了時,そのタスクがロックしていたミューテックスはロック解除されます。
戻り値
マクロ
数値
意味
E_OK
0
正常終了
E_ID
-18
不正ID番号
- mtxid≦0
- mtxidVTMAX_MTX
E_CTX
-25
コンテキスト・エラー
- 非タスクから本サービス・コールを発行した。
- CPUロック状態から本サービス・コールを発行した。
- 「PSW.IPL > カーネル割り込みマスクレベル」の状態から本サービス・コールを発行した。
E_ILUSE
-28
サービス・コール不正使用
- 自タスクは対象ミューテックスをロックしていない。