del_mtx

概要

ミューテックスの削除

C言語形式

 ER      del_mtx ( ID mtxid );
パラメータ

I/O

パラメータ

説明

I

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



機能

本サービス・コールは,信頼されたドメインに所属するタスクからのみ呼び出せます。

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

対象ミューテックスをロックしているタスクがある場合,そのロックを解除します。その結果,そのタスクがロックしているミューテックスがなくなった場合には,そのタスクの現在優先度をベース優先度に戻します。対象ミューテックスをロックしていたタスクには,ミューテックスが削除されたことは通知されません。後でunl_mtxによってミューテックスをロック解除しようとした時点で,エラーE_NOEXS が返されます。

対象ミューテックスでloc_mtxまたはtloc_mtxによって待っているタスクがある場合は,そのタスクの待ち状態を解除し,loc_mtxまたはtloc_mtxの戻り値としてE_DLTを返します。

戻り値

マクロ

数値

意味

E_OK

0

正常終了

E_ID

-18

不正ID番号

- mtxid≦0

- mtxid > VTMAX_MTX

E_CTX

-25

コンテキスト・エラー

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

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

- 「PSW.IPL > カーネル割り込みマスクレベル」の状態から本サービス・コールを発行した。

E_MACV

-26

メモリ・アクセス違反

- スタック・ポインタが呼出しタスクのユーザ・スタック領域の範囲外を指している。

E_OACV

-27

オブジェクト・アクセス違反

- 呼出しタスクは,信頼されたドメインに所属していない。

E_NOEXS

-42

オブジェクト未生成

- mtxidのミューテックスが存在しない。