機能
サンプリング停止イベントが発生した場合割り込みイベントコールバック関数を指定します。
書式
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