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;        /*現在状態*/
         UH      RFU1;           /*システム予約領域*/
         RELTIM  lefttim;        /*残り時間*/
         ATR     cycatr;         /*属性*/
         UH      RFU2;           /*システム予約領域*/
         RELTIM  cyctim;         /*起動周期*/
         RELTIM  cycphs;         /*初期起動位相*/
 } T_RCYC;


機能

cycidで指定された周期ハンドラの周期ハンドラ詳細情報(現在状態,残り時間など)をpk_rcycで指定された領域に格納します。

備考 周期ハンドラ詳細情報T_RCYCについての詳細は,「15.2.12 周期ハンドラ詳細情報」を参照してください。

戻り値

マクロ

数値

意味

E_OK

0

正常終了

E_ID

-18

IDの指定が不正である

- cycid≦0x0

- cycid>生成されている周期ハンドラの最大ID

E_CTX

-25

CPUロック状態から本サービス・コールを発行した

E_NOEXS

-42

対象周期ハンドラが生成されていない