AioSetAoEvent

機能

アナログ出力に関するWindowメッセージ通知のイベント要因を設定します。

書式

Ret = AioSetAoEvent ( Id , hWnd , AoEvent )

引数

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

hWnd [ VB.NET： IntPtr ] [ C, C++： HWND ] [ C#： IntPtr ] [ Python： ctypes.wintypes.HANDLE ]
Windowハンドルを指定します。

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

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

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

戻り値

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

初期値

全てのデバイスでAoEvent = 0（イベント未使用）

説明

この関数で設定されたイベント要因は、イベントメッセージルーチンにメッセージとして通知されます。
メッセージの種類は次の通りです。

アナログ出力機能を持たないデバイスでは使用できません。
デバイスが動作中の場合、この関数は実行できません。
コールバックルーチン（AioSetAoCallBackProc）との併用はできません。

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

使用例

デバイス動作終了イベント、指定ジェネレーティング回数格納イベントを設定します。

関連項目

AioGetAoEvent AioSetAoEventSamplingTimes AioGetAoEventSamplingTimes

イベントメッセージルーチン

AioSetAoEvent関数で設定したイベント要因が発生すると、イベントメッセージルーチンが呼び出されます。

イベントメッセージルーチンで渡される引数には、３つ重要な値があります。[メッセージ番号]、[デバイスID]、[イベントごとの固有パラメータ]
各引数の詳細は、以下の通りです。

・メッセージ番号 (m.Msgプロパティ/message引数)

・デバイスID (m.WParamプロパティ/wParam引数)

同一PC上で複数デバイスを利用している場合、イベントメッセージルーチン内でデバイスIDを判別することで、イベントを発生させたデバイスが特定してください。

単一デバイスのみを利用している場合は、イベントメッセージルーチン内でデバイスIDを判別する必要はありません。
[メッセージ番号]と[イベントごとの固有パラメータ]とで、イベントメッセージルーチン内の処理を行うことができます。

・イベントごとの固有パラメータ (m.LParamプロパティ/lParam引数)

イベントメッセージルーチン処理の記述方法は、利用している開発言語によって異なります。

以下に、イベントメッセージルーチンをオーバーライドする方法と、引数の概略を示します。
詳細は、Microsoft社から提供されているドキュメントを参照ください。

Visual Basic .NET使用時のイベントメッセージルーチン(WndProc使用)

オーバーライド方法

Protected Overrides Sub WndProc(ByRef m As System.Windows.Forms.Message)

引数System.Windows.Forms.Message構造体の以下の３つのプロパティを参照ください。

m.Msg：メッセージ番号が渡されます。
m.WParam：下位２バイトにデバイスIDが渡されます。上位２バイトは現在使用しません。
m.LParam：イベントごとに固有のパラメータが渡されます。

Visual C# .NET使用時のイベントメッセージルーチン(WndProc使用)

オーバーライド方法

[System.Security.Permissions.PermissionSet(System.Security.Permissions.SecurityAction.Demand, Name="FullTrust")]
protected override void WndProc (ref Message m)

引数Message構造体内の以下の３つのプロパティを参照ください。

 
m.Msg：メッセージ番号が渡されます。
m.WParam：下位２バイトにIDが渡されます。上位２バイトは現在使用しません。
m.LParam：イベントごとに固有のパラメータが渡されます。

Visual C++使用時のイベントメッセージルーチン

オーバーライド方法

LRESULT CVC6Dlg::DefWindowProc(UINT message, WPARAM wParam, LPARAM lParam);

DefWindowsProcメッセージルーチンの３つの引数を参照ください。

各引数の詳細は、以下の通りです。

message：メッセージ番号が渡されます。
wParam：下位２バイトにIDが渡されます。上位２バイトは現在使用しません。
lParam：イベントごとに固有のパラメータが渡されます。