AioSetAiCallBackProc

機能

アナログ入力に関するイベントが発生した際に呼び出されるコールバック関数を登録します。

書式

Ret = AioSetAiCallBackProc ( Id , CallBackProc , AiEvent , Param)

引数

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

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

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

デバイスバッファ使用時とユーザーバッファ使用時で使用可能なイベント要因が異なります。

指定サンプリング回数格納イベントを使用する場合、AioSetAiEventSamplingTimes関数でイベントを発生させるサンプリング回数を設定してください。

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

戻り値

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

説明

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

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

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

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

Ethernetデバイスの場合
    デバイスとの通信が途切れるとプロセスの登録が解除され、イベントが通知されなくなります。
    イベント通知を再び行う場合、本関数で再度設定を行ってしてください。

使用例

デバイス動作終了、指定サンプリング回数格納イベント要因でコールバック関数を登録します。

関連項目

コールバック関数

書式

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 ]
ドライバからパラメータが渡されます。現在は使用しません。

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

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