AioSetTmCallBackProc

機能

インターバルタイマに関するイベントが発生した際に呼び出されるコールバック関数を登録します。

書式

Ret = AioSetTmCallBackProc ( Id , TimerId , CallBackProc , TmEvent , Param)

引数

Id [ C, C++： short ] [ Python： ctypes.c_short ]
AioInit 関数で取得したデバイスＩＤを指定します。

TimerId [ C, C++： short ] [ Python： ctypes.c_short ]
タイマIDを指定します。

CallBackProc [ C, C++： long * ] [ Python： ctypes.POINTER(ctypes.c_long) ]
コールバック関数のアドレスを指定します。

TmEvent [ C, C++： long ] [ Python： ctypes.c_long ]
コールバック関数を呼び出すイベント要因を、以下の範囲からマクロもしくは数値で指定します。
AiEventはビット単位で以下のような意味を持ち、これらを組み合わせて指定可能です。

Param [ C, C++： void * ] [ Python： ctypes.c_void_p ]
コールバックに渡すパラメータのアドレスを指定します。
パラメータが必要ない場合は、NULLを指定してください。

戻り値

Ret [ C, C++： long ] [ Python： ctypes.c_long ]

説明

この関数を使用してコールバック関数の登録を行うことで、デバイスで何らかのイベントが発生した際にコールバック関数が呼び出されます。

タイマ機能を持たないデバイスでは使用できません。
デバイスが動作中の場合、この関数は実行できません。

AioStopTmTimer関数を実行した時には、コールバック関数は呼ばれません。

コールバックルーチン内では、デバイスの動作を開始･停止する関数を実行することはできません。

使用例

インターバル成立イベント要因でタイマID０にコールバック関数を登録します。

コールバック関数

書式

Ret = CallBackProc ( Id , Message , wParam , lParam , Param )

引数

Id [ C, C++： short ] [ Python： ctypes.c_short ]
AioInit 関数で取得したＩＤが渡されます。

Message [ C, C++： short ] [ Python： ctypes.c_short ]
コールバック関数呼び出しの原因となるメッセージ番号が渡されます。
メッセージ番号は、以下のいずれかの値です。

wParam [ C, C++： long ] [ Python： ctypes.c_long ]
TimerIdの値が渡されます。

lParam [ C, C++： long ] [ Python： ctypes.c_long ]
イベントごとに固有のパラメータが渡されます。

Param [ C, C++： void * ] [ Python： ctypes.c_void_p ]
AioSetTmCallBackProc関数に指定したパラメータが渡されます。
パラメータにNULLが指定された場合、ここにはNULLが格納されます。