Everything

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
- 非タスクから本サービス・コールを発行した際,tskidTSK_SELFを指定した。
E_CTX
-25
コンテキスト・エラー
- CPUロック状態から本サービス・コールを発行した。
- 「PSW.IPL > カーネル割り込みマスクレベル」の状態から本サービス・コールを発行した。
備考 タスクからiref_texを発行した場合,および非タスクからref_texを発行した場合,コンテキスト・エラーは検出されず,システムの正常な動作は保証されません。
E_MACV
-26
メモリ・アクセス違反(ref_texのみ)
- 呼び出しタスクからのpk_rtexが示す領域に対するオペランド・ライト・アクセス許可がない。
E_NOEXS
-42
オブジェクト未生成
- tskidのタスクが存在しない。