DioReadCount

Function

Retrieves the count values.

Format

Ret = DioReadCount ( Id , ChNo , ChNum , Count)

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 for which count values are to be acquired.

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

Count[ VB.NET: Integer ] [ C, C++: unsigned long * ] [ C#: out uint ] [ Python: ctypes.POINTER(ctypes.c_ulong) ]
Specify the start address of the array that stores the count values.

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	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 count values of the specified channels.

In the case of a wireless I/O device, it acquires the data of the slave unit stored in the master unit.
Please note that it is not real time information of the slave unit.
Please use the DioReadCountSR function when acquiring the real time information of the slave unit.

Example

Retrieves the count values of channel 0 and channel 1.

VB.NET	Dim Ret As Integer Dim ChNo As Short Dim Count As Integer ChNo(0) = 0 ChNo(1) = 1 Ret = DioReadCount( Id , ChNo , 2 , Count )
C, C++	long Ret; short ChNo[2] unsigned long Count[2]; ChNo[0] = 0; ChNo[1] = 1; Ret = DioReadCount( Id , ChNo , 2 , Count );
C#	int Ret; short[] ChNo = new short[2]; uint[] Count = new uint[2]; ChNo[0] = 0; ChNo[1] = 1; Ret = dio.DioReadCount( Id , ChNo , 2 , Count );
Python	Ret = ctypes.c_long() ChNoType = ctypes.c_short * 2 ChNo = ChNoType() CountType = ctypes.c_ulong * 2 Count = CountType() ChNo[0] = 0 ChNo[1] = 1 Ret.value = cdio.DioReadCount( Id , ChNo , 2 , Count )