Everything

ref_alm

iref_alm

概要
アラーム・ハンドラ詳細情報の参照
C言語形式
 ER      ref_alm ( ID almid, T_RALM *pk_ralm );
 ER      iref_alm ( ID almid, T_RALM *pk_ralm );
パラメータ
I/O
パラメータ
説明
I
 ID      almid;
アラーム・ハンドラのID
O
 T_RALM  *pk_ralm;
アラーム・ハンドラ詳細情報を格納する領域へのポインタ

【 アラーム・ハンドラ詳細情報T_RALMの構造 】
 typedef struct  t_ralm {
         STAT    almstat;        /*現在状態*/
         RELTIM  lefttim;        /*残り時間*/
 } T_RALM;

機能
almidで指定されたアラーム・ハンドラのアラーム・ハンドラ詳細情報(現在状態,残り時間など)をpk_ralmで指定された領域に格納します。
- almstat
アラーム・ハンドラの現在状態が格納されます。
TALM_STP: 停止状態(STP状態)
TALM_STA: 動作状態(STA状態)
- lefttim
アラーム・ハンドラが次に起動するまでの残り時間(単位:ミリ秒)が格納されます。対象アラーム・ハンドラが停止状態の場合,lefttimは不定値となります。
戻り値
マクロ
数値
意味
E_OK
0
正常終了
E_PAR
-17
パラメータ・エラー
- pk_ralm == NULL
E_ID
-18
不正ID番号
- almid≦0
- almid > VTMAX_ALH
E_CTX
-25
コンテキスト・エラー
- CPUロック状態から本サービス・コールを発行した。
- 「PSW.IPL > カーネル割り込みマスクレベル」の状態から本サービス・コールを発行した。
備考 タスクからiref_almを発行した場合,および非タスクからref_almを発行した場合,コンテキスト・エラーは検出されず,システムの正常な動作は保証されません。
E_MACV
-26
メモリ・アクセス違反(ref_almのみ)
- 呼び出しタスクからのpk_ralmが示す領域に対するオペランド・ライト・アクセス許可がない。
E_NOEXS
-42
オブジェクト未生成
- almidのアラーム・ハンドラが存在しない。