DioReadCountSR

機能

ワイヤレスI/Oデバイスでカウント値を取得します。

書式

Ret = DioReadCountSR ( Id , ChNo , ChNum , Count, Timestamp , Mode )

引数

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

ChNo [ VB.NET： Short ] [ C, C++： short * ] [ C#： out short ] [ Python: ctypes.POINTER(ctypes.c_short) ]
カウント値取得を行うチャネル番号を格納した配列の先頭アドレスを指定します。

ChNum [ VB.NET： Short ] [ C, C++： short ] [ C#： short ] [ Python: ctypes.c_short ]
ChNoで指定したチャネル数を指定します。

Count[ VB.NET： Integer ] [ C, C++： unsigned long * ] [ C#： out uint ] [ Python: ctypes.POINTER(ctypes.c_ulong) ]
カウント値を格納する配列の先頭アドレスを指定します。

Timestamp [ VB.NET： UShort] [ C, C++： unsigned short  * ] [ C#： out ushort ] [ Python: ctypes.POINTER(ctypes.c_ushort) ]
タイムスタンプを格納するアドレスを指定します。
Modeで参照先を親機に指定した場合、前回の更新からの時間が格納されます。

Mode [ VB.NET： Byte ] [ C, C++： BYTE ] [ C#： out byte ] [ Python: ctypes.c_ubyte ]
入力データを参照する先を指定します。

定義

値

[Dec]

意味

DIONET_MODE_DIRECT

0

子機の入力データを参照します。

DIONET_MODE_AP

1

親機の入力データを参照します。

戻り値

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

定義

値

[Dec]

意味

DIO_ERR_SUCCESS

0

正常終了

DIO_ERR_SYS_RECOVERED_FROM_STANDBY

7

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

DIO_ERR_DLL_INVALID_ID

10001

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

DIO_ERR_DLL_CALL_DRIVER

10002

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

DIO_ERR_DLL_BUFF_ADDRESS

10100

データバッファアドレスが不正です。

DIO_ERR_SYS_NOT_SUPPORTED

20001

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

DIO_ERR_SYS_CH_NO

20105

チャネル番号が指定可能範囲外です。

DIO_ERR_SYS_CH_NUM

20106

チャネル数が指定可能範囲外です。

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

説明

指定したチャネルのカウント値を取得します。
データ取得の方法として、親機に保存されているデータ取得と子機のデータを直接取得する2種類を選択できます。
それぞれの取得方法の特徴についてはワイヤレスI/Oの仕様をご参照ください。

データ取得方法で、親機に保存されているデータ取得を行う場合、親機に保存されているデータのタイムスタンプが取得できます。
タイムスタンプは前回の更新からの時間を秒単位で返します。
子機の更新間隔よりもタイムスタンプが長い場合、子機からのデータが何かしらの理由により親機に到達していないことになります。
親機に保存されているデータの有効性確認にご使用ください。
 

使用例

チャネル0とチャネル1のカウント値を子機から取得します。

VB.NET

Dim Ret As Integer
Dim ChNo As Short
Dim Count As Integer
Dim Timestamp As UShort
Dim Mode As Byte

ChNo(0) = 0
ChNo(1) = 1
Mode = 0
Ret = DioReadCountSR( Id , ChNo , 2 , Count , Timestamp , Mode )
　

C, C++

long Ret;
short ChNo[2]
unsigned long Count[2];
unsigned short Timestamp;
BYTE Mode;

ChNo[0] = 0;
ChNo[1] = 1;
Mode = 0;
Ret = DioReadCountSR( Id , ChNo , 2 , Count , &Timestamp , Mode );
　

C#

int Ret;
short[] ChNo = new short[2];
uint[] Count = new uint[2];
ushort Timestamp;
byte Mode;

ChNo[0] = 0;
ChNo[1] = 1;
Mode = 0;
Ret = dio.DioReadCountSR( Id , ChNo , 2 , Count , out Timestamp , Mode );
　

Python

Ret = ctypes.c_long()
ChNoType = ctypes.c_short * 2
ChNo = ChNoType()
CountType = ctypes.c_ulong * 2
Count = CountType()
Timestamp = ctypes.c_ushort()
Mode = ctypes.c_ubyte()

ChNo[0] = 0
ChNo[1] = 1
Mode.value = 0
Ret.value = cdio.DioReadCountSR( Id , ChNo , 2 , Count , ctypes.byref(Timestamp) , Mode )
　

関連項目

DioStartCount DioReadCount