DioSetCountMatchValue

Function

Sets the comparison register.

Format

Ret = DioSetCountMatchValue ( Id , ChNo , ChNum , CompareRegNo, CompareCount )

Parameters

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

ChNo [ VB.NET: Short ] [ C, C++: short * ] [ C#: out short ] [ Python: ctypes.POINTER(ctypes.c_short) ]
Specify the start address of the array that stores the channel numbers to set.

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

CompareRegNo [ VB.NET: Short ] [ C, C++: short * ] [ C#: out short ] [ Python: ctypes.POINTER(ctypes.c_short) ]
Specify the start address of the array that stores the register number of the comparison registers.

Device	Settable value
CPSN-DI-16BCL	0 only

CompareCount [ VB.NET: Integer ] [ C, C++: unsigned long * ] [ C#: out uint ] [ Python: ctypes.c_ulong ]
Specify the start address of the array that stores the comparison values to be set in the comparison registers.

Specifiable range:
For 32-bit counter devices : 0h <= Count <= FFFFFFFFh

Return Value

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

Definition	Value [Dec]	Description
DIO_ERR_SUCCESS	0	Normal completed
DIO_ERR_SYS_RECOVERED_FROM_STANDBY	7	Execute DioResetDevice function because the device has recovered from standby mode
DIO_ERR_DLL_INVALID_ID	10001	Invalid ID specified.
DIO_ERR_DLL_CALL_DRIVER	10002	Not call the driver (Failure on DEVICE I/O CONTROL).
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	The channel number is out of specifiable range.
DIO_ERR_SYS_CH_NUM	20106	The number of channels is out of the specifiable range.
DIO_ERR_SYS_CMP_REG_NO	20800	The comparison register number is out of the specifiable range.
DIO_ERR_SYS_CMP_REG_VAL	20801	The comparison register value is out of the specifiable range.

The others (See also: Details of Error Code)

Remarks

- You can use DioGetCountStatus to check if it matches the specified count value.

Example

Set the comparison count value to 500 for the comparison register 0 of channel 0, and set the comparison count value to 1000 for the comparison register 0 for channel 1.

VB.NET	Dim Ret As Integer Dim ChNo As Short Dim CompareRegNo As Short Dim CompareCount As Integer ChNo(0) = 0 ChNo(1) = 1 CompareRegNo(0) = 0 CompareRegNo(1) = 0 CompareCount(0) = 500 CompareCount(1) = 1000 Ret = DioSetCountMatchValue( Id , ChNo , 2 , CompareRegNo, CompareCount )
C, C++	long Ret; short ChNo[2] short CompareRegNo[2]; unsigned long CompareCount[2]; ChNo[0] = 0; ChNo[1] = 1; CompareRegNo[0] = 0; CompareRegNo[1] = 0; CompareCount[0] = 500; CompareCount[1] = 1000; Ret = DioSetCountMatchValue( Id , ChNo , 2 , CompareRegNo, CompareCount );
C#	int Ret; short[] ChNo = new short[2]; short[] CompareRegNo = new short[2]; uint[] CompareCount = new uint[2]; ChNo[0] = 0; ChNo[1] = 1; CompareRegNo[0] = 0; CompareRegNo[1] = 0; CompareCount[0] = 500; CompareCount[1] = 1000; Ret = dio.SetCountMatchValue( Id , out ChNo , 2 , out CompareRegNo, out CompareCount );
Python	Ret = ctypes.c_long() ChNoType = ctypes.c_short * 2 ChNo = ChNoType() CompareRegNoType = ctypes.c_short * 2 CompareRegNo = CompareRegNoType() CompareCountType = ctypes.c_ulong * 2 CompareCount = CompareCountType() ChNo[0] = 0 ChNo[1] = 1 CompareRegNo[0] = 0 CompareRegNo[1] = 0 CompareCount[0] = 500 CompareCount[1] = 1000 Ret.value = cdio.DioSetCountMatchValue( Id , ChNo , 2 , CompareRegNo, CompareCount )