DioSetPulseMeasurementSetting

機能

指定したチャネルのパルス計測パラメータを設定します。

書式

Ret = DioSetPulseMeasurementSetting ( Id , ChNo , ChNum , MeasurementTarget, PulsePeriod )

引数

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で指定したチャネル数を指定します。

MeasurementTarget [ VB.NET： UShort ] [ C, C++： unsigned short * ] [ C#： out ushort ] [ Python: ctypes.POINTER(ctypes.c_ushort) ]
パルス計測時間設定を格納した配列の先頭アドレスを指定します。

定義

値

[Dec]

意味

DIO_PULSE_MEASUREMENT_TARGET_OFF_TIME

0

OFF時間を計測

DIO_PULSE_MEASUREMENT_TARGET_ON_TIME

1

ON時間を計測

PulsePeriod [ VB.NET： UShort ] [ C, C++： unsigned short * ] [ C#： out ushort ] [ Python: ctypes.POINTER(ctypes.c_ushort) ]
パルス計測周期設定を格納した配列の先頭アドレスを指定します。

値

[Dec]

意味

0

25nsec

1

50nsec

2

100nsec

3

200nsec

4

400nsec

5

800nsec

6

1.6µsec

7

3.2µsec

8

6.4µsec

9

12.8µsec

10

25.6µsec

11

51.2µsec

12

102.4µsec

13

204.8µsec

14

409.6µsec

15

819.2µsec

16

1.6384msec

17

3.268msec

18

6.5536msec

19

13.1072msec

20

26.2144msec

戻り値

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

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

DIO_ERR_SYS_PULSE_MEASUREMENT_TARGET

20950

パルス計測時間が指定可能範囲外です。

DIO_ERR_SYS_PULSE_MEASUREMENT_PERIOD

20951

パルス計測周期が指定可能範囲外です。

DIO_ERR_SYS_PULSE_MEASUREMENT_RUNNING

20952

パルス計測動作中のため実行できません。

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

初期値

MeasurementTarget = DIO_PULSE_MEASUREMENT_TARGET_OFF_TIME(0)
PulsePeriod = 25nsec (0)

説明

指定したチャネルのパルス計測パラメータを設定します。

パルス計測中に本関数は実行できません。

使用例

チャネル0のパルス計測時間を「ON時間を計測」、パルス計測周期を「100nsec」に設定します。

VB.NET

Dim Ret As Integer
Dim ChNo(0) As Short
Dim MeasurementTarget(0) As UShort
Dim PulsePeriod(0) As UShort

ChNo(0) = 0
MeasurementTarget(0) = DIO_PULSE_MEASUREMENT_TARGET_ON_TIME
PulsePeriod(0) = 2
Ret = DioSetPulseMeasurementSetting( Id , ChNo , 1 , MeasurementTarget , PulsePeriod )
　

C, C++

long Ret;
short ChNo[1]
unsigned short MeasurementTarget[1];
unsigned short PulsePeriod[1];

ChNo[0] = 0;
MeasurementTarget[0] = DIO_PULSE_MEASUREMENT_TARGET_ON_TIME;
PulsePeriod[0] = 2;
Ret = DioSetPulseMeasurementSetting( Id , &ChNo[0] , 1 , &MeasurementTarget[0] , &PulsePeriod[0] );
　

C#

int Ret;
short[] ChNo = new short[1];
ulong[] MeasurementTarget = new ulong[1];
ushort[] PulsePeriod = new ushort[1];

ChNo[0] = 0;
MeasurementTarget[0] = DIO_PULSE_MEASUREMENT_TARGET_ON_TIME;
PulsePeriod[0] = 2;
Ret = dio.SetPulseMeasurementSetting( Id , ref ChNo , 1 , out MeasurementTarget , out PulsePeriod );
　

Python

Ret = ctypes.c_long()
ChNoType = ctypes.c_short * 1
ChNo = ChNoType()
MeasurementTargetType = ctypes.c_ushort * 1
MeasurementTarget = MeasurementTargetType()
PulsePeriodType = ctypes.c_ushort * 1
PulsePeriod = PulsePeriodType()

ChNo[0] = 0
MeasurementTarget[0] = cdio.DIO_PULSE_MEASUREMENT_TARGET_ON_TIME
PulsePeriod[0] = 2
Ret.value = cdio.DioSetPulseMeasurementSetting( Id , ChNo , 1 , MeasurementTarget , PulsePeriod )
　

関連項目

DioGetPulseMeasurementSetting