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の周期ハンドラが存在しない。