User manual - デバイス制御ライブラリリファレンスマニュアル(2014年10月10日)

132
10.6.4 s_settimer
タイマ 1 にイベントの発生間隔を登録し、通知を有効にします。イベントの発生間隔は 1 秒単位（最大 60
分）で指定でき、最大で 10 種類の値を登録することができます。登録に成功すると 0～9 のタイマ登録ID
を返します。このタイマ登録IDは、s_timerend関数による登録の削除に使います。
ER s_settimer(
ID flgid ,
UW setptn ,
UW tmcnt
);
パラメータ
flgid
対象のイベントフラグ ID を指定します。アプリケーションプログラムから呼び出す場合、この値は
FL_TM1_INT_ID 固定です。
setptn
タイムアップ時にイベントフラグにセットするビットを FL_TM1_INT_RTC0 ～ FL_TM1_INT_RTC31 の
範囲で指定します。複数のビットを OR で指定することもできます。
tmcnt
タイマカウントを 1～3600（1 カウント = 1 秒）の範囲で指定します。
戻り値
登録に成功すると 0～9 のタイマ登録 ID が返ります。失敗すると次のエラーが返ります。
E_PRM
：パラメータエラー
E_TID_OVER
：登録数オーバー
注意
本関数で登録したタイマーは s_timerend関数で削
除するまで、指定された発生間隔でイベントの通
知を繰り返します。
イベントを受け取ったアプリケーションプログラムは適当な処理を行い、clr_flg関数
でイベントをクリアし
てください。
イベントの通知が不要になったら s_timerend関数でタイマの登録を削除してください。
タイマは最大+1 秒の誤差が生じます。
参照
s_timerend関数