CntNotifySamplingCount


機能

指定個数サンプリング完了の通知設定を行います。

書式

Ret =CntNotifySamplingCount ( Id , Count , hWnd )

引数

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

Count [ VB.NET: Integer ] [ C, C++: long ] [ C#: int ] [ Python: ctypes.c_long ]
通知を行うサンプリング回数を指定します。
ここで指定した回数サンプリングするごとに、アプリケーションに通知されます。

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

hWnd [ VB.NET: IntPtr ] [ C, C++: HWND ] [ C#: IntPtr ] [ Python: ctypes.wintypes.HANDLE ]
指定個数サンプリング完了の通知を受け取るウィンドウハンドルを指定します。
ウィンドウハンドルは、VCの場合は、m_hWndで取得できます。
ウインドウメッセージを使用せず、コールバックを使用する場合は0を指定してください。

戻り値

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

定義

意味

CNT_ERR_SUCCESS

0

正常終了

CNT_ERR_SYS_RECOVERED_FROM_STANDBY

7

スタンバイモードから復帰したため、CntResetDevice関数を実行してください

CNT_ERR_DLL_INVALID_ID

10001

無効なIDが指定されました

CNT_ERR_DLL_CALL_DRIVER

10002

 ドライバーを呼び出せません。(デバイスI/Oコントロールに失敗)

CNT_ERR_DLL_CREATE_THREAD

10005

スレッドの作成に失敗しました(CreateThread失敗)

CNT_ERR_DLL_HWND

10200

ウィンドウハンドルが指定可能範囲外です

CNT_ERR_SYS_NOT_SUPPORTED

20001

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

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

説明

この関数は、サンプリングをスタートする前の設定段階で実行してください。
割り込みが発生すると、指定したウィンドウハンドルに、以下のメッセージがPostMessageされます。

定義

CNTM_SAMPLING_COUNT

1151H

メッセージのパラメータである、wParam、lParamには、それぞれ以下の情報が入ります。
LOWORD(wParam)=CntInit関数で取得したID
lParam=ドライバーからパラメータが渡されます。現在は使用しません。
※HIWORD、LOWORDは、それぞれ上位ワード、下位ワードを表します。
メッセージ処理の記述方法詳細については、各言語のサンプルプログラムを参照してください。

CntResetDeviceを呼び出すと、割り込みが無効になります。

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

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

使用例

指定個数サンプリング完了の通知設定を行います。

VB.NET

Dim Ret As Integer
Ret = CntNotifySamplingCount ( Id , Count , Handle )
 

C, C++

long Ret;
Ret = CntNotifySamplingCount ( Id , Count , m_hWnd );
 

C#

int Ret;
Ret = cnt.NotifySamplingCount ( Id , Count , Handle );
 

Python

Ret = ctypes.c_long()
handle = ctypes.windll.user32.FindWindowW(0, "割り込み")
Ret.value = ccnt.CntNotifySamplingCount ( Id , Count , handle )
 

関連項目

CntSamplingCountCallbackProc CntGetNetCommunicationInfo