DioGetCountStatus

Function

Retrieves the count status.

Format

Ret = DioGetCountStatus ( Id , ChNo , ChNum , CountStatus )

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 get setting.

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

CountStatus [ 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 status.

When using <CPSN-DI-16BCL>

Bit	Description	Value
0	Comparison match	0: Not matched 1: Matched (Clear when reading)
1	Carry	0: Carry undetection 1: Carry detection (Clear when reading)
31:2	Reserved	-

When using <DIO-0404LY-WQ>

Bit	Description	Value
0	Reserved	-
1	Carry	0: Carry undetection 1: Carry detection (Clear when reading)
2	Counter operation status	0: Stop 1: In operation
31:3	Reserved	-

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)

Example

Retrieves the count status of channel 0 and channel 1.

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