CntSetSamplingStopEvent


機能

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

書式

Ret = CntSetSamplingStopEvent ( Id , CallBackProc , Param )

引数

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

CallBackProc [ C: PCNT_SAMPLING_STOP_CALLBACK ] [ Python: PCNT_SAMPLING_STOP_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_SYS_NOT_SUPPORTED

20001

このデバイスではこの関数は使用できません

その他のエラー(参照:エラーコード詳細

説明

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

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

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

 

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

使用例

C

Ret = CntSetSamplingStopEvent(Id, CallBackProc, Param);
 

Python

Ret = ccnt.CntSetSamplingStopEvent(Id, CallBackProc, Param)
 

関連項目

PCNT_SAMPLING_STOP_CALLBACK CntGetNetCommunicationInfo