ref_mtx

概要

ミューテックス詳細情報の参照

C言語形式

 ER      ref_mtx ( ID mtxid, T_RMTX *pk_rmtx );

パラメータ

I/O	パラメータ	説明
I	ID mtxid;	ミューテックスのID
O	T_RMTX *pk_rmtx;	ミューテックス詳細情報を格納する領域へのポインタ

【 ミューテックス詳細情報T_RMTXの構造 】

typedef struct t_rmtx { ID htskid; /*ロックの有無*/ ID wtskid; /*待ちタスクの有無*/ } T_RMTX;

機能

mtxidで指定されたミューテックスのミューテックス詳細情報（ロックの有無，待ちタスクの有無など）をpk_rmtxで指定された領域に格納します。

- htskid
ミューテックスをロックしているタスクが存在しているか否かが格納されます。

TSK_NONE： ロックしているタスクは存在しない

その他： ロックしているタスクのID

- wtskid
ミューテックスの待ちキューにタスクがキューイングされているか否かが格納されます。

TSK_NONE： 待ちキューにタスクはキューイングされていない

その他： 待ちキューの先頭にキューイングされているタスクのID

戻り値

マクロ	数値	意味
E_OK	0	正常終了
E_PAR	-17	パラメータ・エラー - pk_rmtx == NULL
E_ID	-18	不正ID番号 - mtxid≦0 - mtxid > VTMAX_MTX
E_CTX	-25	コンテキスト・エラー - 非タスクから本サービス・コールを発行した。 - CPUロック状態から本サービス・コールを発行した。 - 「PSW.IPL > カーネル割り込みマスクレベル」の状態から本サービス・コールを発行した。
E_MACV	-26	メモリ・アクセス違反 - 呼び出しタスクからのpk_rmtxが示す領域に対するオペランド・ライト・アクセス許可がない。
E_NOEXS	-42	オブジェクト未生成 - mtxidのミューテックスが存在しない。