CntSetSamplingCountEvent

機能

指定個数サンプリング完了イベントが発生した場合割り込みイベントコールバック関数を指定します。

書式

Ret = CntSetSamplingCountEvent ( Id, Count, CallBackProc, Param )

引数

Id [ C： short ] [ Python： ctypes.c_short ]
CntInitで取得したデバイスIDを指定します。

Count [ C： unsigned int ] [ Python： ctypes.c_uint ]
通知を行うサンプリング回数を指定します。
ここで指定した回数サンプリングするごとに、アプリケーションに通知されます。

指定可能範囲:
Count <= (FFFFFFh / サンプリングチャネル数)

CallBackProc [ C： PCNT_SAMPLING_COUNT_CALLBACK ] [ Python： PCNT_SAMPLING_COUNT_CALLBACK ]
コールバック関数のアドレスを指定します。
NULLを指定するとコールバックによる通知設定をクリアします。

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

戻り値

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

定義	値	意味
CNT_ERR_SUCCESS	0	正常終了
CNT_ERR_DLL_INVALID_ID	10001	無効なIDが指定されました
CNT_ERR_DLL_CALL_DRIVER	10002	ドライバを呼び出せません。(ioctlに失敗)
CNT_ERR_DLL_CREATE_THREAD	10005	スレッドの作成に失敗しました(CreateThread失敗)
CNT_ERR_SYS_NOT_SUPPORTED	20001	このデバイスではこの関数は使用できません

その他のエラー（参照：エラーコード詳細）

説明

指定個数サンプリング完了割り込み機能を使用して、割り込みを受け付ける機能です。
割り込みコールバック設定を行った後、割り込みが発生すると、
設定したコールバック関数が呼び出されます。

Ethernetデバイスの場合
デバイスとの通信が途切れるとプロセスの登録が解除され、イベントが通知されなくなります。

イベント通知を再び行う場合、本関数で再度設定を行ってしてください。

現在のプロセスの登録状況は、CntGetNetCommunicationInfo関数で確認できます。

使用例

C	Ret = CntSetSamplingCountEvent(Id, Count, CallBackProc, Param);
Python	Ret = ccnt.CntSetSamplingCountEvent(Id, Count, CallBackProc, Param)