loc_mtx

概要

ミューテックスのロック

C言語形式

 ER      loc_mtx ( ID mtxid );


パラメータ

I/O

パラメータ

説明

I

 ID      mtxid;
ミューテックスのID



機能

mtxidで指定されたミューテックスをロックします。

ただし,本サービス・コールを発行した際,対象ミューテックスをロックすることができなかった(すでに他タスクがロックしていた)場合には,自タスクを対象ミューテックスの待ちキューにキューイングしたのち,RUNNING状態からWAITING状態(ミューテックス待ち状態)へと遷移させます。

なお,ミューテックス待ち状態の解除は,以下の場合に行われ,ミューテックス待ち状態からREADY状態へと遷移します。

 
ミューテックス待ち状態の解除操作

エラー・コード

unl_mtxの発行により,対象ミューテックスのロック状態が解除された

E_OK

ext_tskの発行により,対象ミューテックスのロック状態が解除された

E_OK

ter_tskの発行により,対象ミューテックスのロック状態が解除された

E_OK

rel_waiの発行により,ミューテックス待ち状態を強制的に解除された

E_RLWAI

irel_waiの発行により,ミューテックス待ち状態を強制的に解除された

E_RLWAI



備考1 自タスクを対象ミューテックスの待ちキューにキューイングする際のキューイング方式は,コンフィギュレーション時に定義された順(FIFO順,優先度順)に行われます。

備考2 RI850V4では,自タスクがロックしているミューテックスに対して本サービス・コールを再発行(ミューテックスの多重ロック)した際には,戻り値としてE_ILUSEを返します。

戻り値

マクロ

数値

意味

E_OK

0

正常終了

E_ID

-18

IDの指定が不正である

- mtxid≦0x0

- mtxid>生成されているミューテックスの最大ID

E_CTX

-25

コンテキスト・エラー

- 非タスクから本サービス・コールを発行した

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

- ディスパッチ禁止状態から本サービス・コールを発行した

E_ILUSE

-28

すでにロック状態へと遷移させているミューテックスに対して本サービス・コールを発行した

E_NOEXS

-42

対象ミューテックスが生成されていない

E_RLWAI

-49

rel_wai,またはirel_waiの発行により,ミューテックス待ち状態を強制的に解除された