AioSetAoCallBackProc

機能

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

書式

Ret = AioSetAoCallBackProc ( Id , CallBackProc , AoEvent , Param)

引数

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

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

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

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

指定ジェネレーティング回数出力イベントを使用する場合、AioSetAoEventSamplingTimes関数でイベントを発生させるジェネレーティング回数を設定してください。

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

戻り値

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

説明

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

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

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

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

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 ]
AioSetAoCallBackProc関数に指定したパラメータが渡されます。
パラメータにNULLが指定された場合、ここにはNULLが格納されます。