AioSetAoCallBackProc

機能

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

書式

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

引数

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

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

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

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

イベント要因	デバイスバッファ使用時	ユーザーバッファ使用時	マクロ	値
DA変換開始条件成立イベント	○	○	AOE_START	00000002H
リピート終了イベント	○	○	AOE_RPTEND	00000010H
デバイス動作終了イベント	○	○	AOE_END	00000020H
指定ジェネレーティング回数出力イベント	○	×	AOE_DATA_NUM	00000080H
指定転送数毎イベント	×	○	AOE_DATA_TSF	00000100H
ジェネレーティングクロック周期エラーイベント	○	○	AOE_SCERR	00020000H
DA変換エラーイベント	○	○	AOE_DAERR	00040000H

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

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

戻り値

Ret [ VB.NET： Integer ] [ C, C++： long ] [ C#： int ] [ Python： ctypes.c_long ]

戻り値	内容
0	正常終了
7	スタンバイモードから復帰したため、AioResetDevice関数を実行してください
10001	無効なIDが指定されました関数に指定するIDは、AioInitで取得したIDを使用してください。
10002	ドライバを呼び出せません始めにAioInit関数を実行しください。
20001	使用しているデバイスではこの関数を使用することができません
20002	デバイスが動作中のため実行できませんこの関数を使用するには、アナログ出力動作が停止している必要があります。
20003	他のプロセスがデバイスを使用しているため、実行できません他のプロセスがデバイスを使用しているときは、マルチプロセス対応関数以外実行できません。

説明

この関数を使用してコールバック関数の登録を行うことで、デバイスで何らかのイベントが発生した際にコールバック関数が呼び出されます。
コールバック関数の動作はイベントと似ていますが、イベントと異なりウィンドウハンドルを必要としないため、ウィンドウを持たないアプリケーションでも使用できます。

アナログ出力機能を持たないデバイスでは使用できません。
デバイスが動作中の場合、この関数は実行できません。
Windowメッセージ通知（AioSetAoEvent）との併用はできません。

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

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

使用例

デバイス動作終了、指定ジェネレーティング回数出力イベント要因でコールバック関数を登録します。

VB.NET	VisualBasic.NETでご使用の際の注意点を参照してください。
C, C++	long Ret; Ret = AioSetAoCallBackProc ( Id , CallBackProc , AOE_END \| AOE_DATA_NUM , this );
C#	VisualC#.NETでご使用の際の注意点を参照してください。
Python	Ret = ctypes.c_long() Ret.value = caio.AioSetAoCallBackProc ( Id , CallBackProc , caio.AOE_END \| caio.AOE_DATA_NUM , 0 );

コールバック関数

書式

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

引数

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

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

アナログ出力メッセージ要因	マクロ	値
DA変換開始条件成立イベント	AIOM_AOE_START	1020H
リピート終了イベント	AIOM_AOE_RPTEND	1021H
デバイス動作終了イベント	AIOM_AOE_END	1022H
指定ジェネレーティング回数出力イベント	AIOM_AOE_DATA_NUM	1023H
指定転送数毎イベント	AIOM_AOE_DATA_TSF	1027H
ジェネレーティングクロック周期エラーイベント	AIOM_AOE_SCERR	1025H
DA変換エラーイベント	AIOM_AOE_DAERR	1026H

wParam [ VB.NET： Integer ] [ C, C++： WPARAM ] [ C#： int ] [ Python： ctypes.wintypes.WPARAM ][ C, C++： long ] [ Python： ctypes.c_long ]
デバイスドライバからパラメータが渡されます。現在は使用しません。

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

イベント要因	パラメータ
DA変換開始条件成立イベント	なし
リピート終了イベント	現在のリピート回数
デバイス動作終了イベント	現在のジェネレーティング回数
指定ジェネレーティング回数出力イベント	現在のジェネレーティング回数
指定転送数毎イベント	現在の転送回数
ジェネレーティングクロック周期エラーイベント	現在のジェネレーティング回数
DA変換エラーイベント	現在のジェネレーティング回数

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