DioGetPulseMeasurementSetting


Function

Retrieves the pulse measurement settings for the specified channel.

Format

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

Parameters

Id [ C, C++: short ] [ Python: ctypes.c_short ]
Specify the device ID retrieved from DioInit.

ChNo [ C, C++: short * ] [ Python: ctypes.POINTER(ctypes.c_short) ]
Specify the start address of the array that stores the channel numbers for which settings are to be retrieved.

ChNum [ C, C++: short ] [ Python: ctypes.c_short ]
Specify the number of channels specified in ChNo.

MeasurementTarget [ C, C++: unsigned short * ] [ Python: ctypes.POINTER(ctypes.c_ushort) ]
Specify the start address of the array that stores the pulse measurement time settings.

PulsePeriod [ C, C++: unsigned short * ] [ Python: ctypes.POINTER(ctypes.c_ushort) ]
Specify the start address of the array that stores the pulse measurement period.

Return Value

Ret [ C, C++: long ] [ Python: ctypes.c_long ]

Definition

Value

[Dec]

Description

DIO_ERR_SUCCESS

0

Normal completed.

DIO_ERR_DLL_INVALID_ID

10001

Invalid ID specified.

DIO_ERR_DLL_CALL_DRIVER

10002

Driver cannot be called (failed in ioctl).

DIO_ERR_DLL_BUFF_ADDRESS

10100

Invalid data buffer address.

DIO_ERR_SYS_NOT_SUPPORTED

20001

This board couldn't use this function.

DIO_ERR_SYS_CH_NO

20105

Channel No. is outside the setting range.

DIO_ERR_SYS_CH_NUM

20106

Channel number is outside the setting range.

The others (See also: Details of Error Code)

Remarks

Retrieves the pulse measurement settings for the specified channel.

Example

Get the pulse measurement settings for channel 0 and channel 1.

C, C++

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

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

Python

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

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

See Also

DioSetPulseMeasurementSetting