ref_tex

iref_tex

概要

タスク例外処理の詳細情報の参照

C言語形式

 ER      ref_tex ( ID tskid, T_RTEX *pk_rtex );

 ER      iref_tex ( ID tskid, T_RTEX *pk_rtex );

パラメータ

I/O	パラメータ	説明
I	ID tskid;	タスクのID TSK_SELF： 自タスク 数値： タスクのID
O	T_RTEX *pk_rtex;	タスク例外処理詳細情報を格納する領域へのポインタ

【 タスク基本情報T_RTEXの構造 】

typedef struct t_rtex { STAT texstat; /*タスク例外処理の状態*/ TEXPTN pndptn; /*保留例外要因*/ } T_RTEX;

機能

tskidで指定されたタスクのタスク例外処理の状態をpk_rtexで指定された領域に格納します。

- texstat
タスク例外処理の状態が格納されます。

TTEX_ENA： タスク例外処理許可状態

TTEX_DIS： タスク例外処理禁止状態

- pndptn
保留されている例外要因パターンが格納されます。

戻り値

マクロ	数値	意味
E_OK	0	正常終了
E_PAR	-17	パラメータ・エラー - pk_rtex == NULL
E_ID	-18	不正ID番号 - tskid < 0 - tskid > VTMAX_TSK - 非タスクから本サービス・コールを発行した際，tskidにTSK_SELFを指定した。
E_CTX	-25	コンテキスト・エラー - CPUロック状態から本サービス・コールを発行した。 - 「PSW.IPL > カーネル割り込みマスクレベル」の状態から本サービス・コールを発行した。 備考 タスクからiref_texを発行した場合，および非タスクからref_texを発行した場合，コンテキスト・エラーは検出されず，システムの正常な動作は保証されません。
E_MACV	-26	メモリ・アクセス違反（ref_texのみ） - 呼び出しタスクからのpk_rtexが示す領域に対するオペランド・ライト・アクセス許可がない。
E_NOEXS	-42	オブジェクト未生成 - tskidのタスクが存在しない。