Everything

ref_cyc

iref_cyc

概要
周期ハンドラ詳細情報の参照
C言語形式
 ER      ref_cyc ( ID cycid, T_RCYC *pk_rcyc );
 ER      iref_cyc ( ID cycid, T_RCYC *pk_rcyc );
パラメータ
I/O
パラメータ
説明
I
 ID      cycid;
周期ハンドラのID
O
 T_RCYC  *pk_rcyc;
周期ハンドラ詳細情報を格納する領域へのポインタ

【 周期ハンドラ詳細情報T_RCYCの構造 】
 typedef struct  t_rcyc {
         STAT    cycstat;        /*現在状態*/
         RELTIM  lefttim;        /*残り時間*/
 } T_RCYC;

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