DioEchoBackMultiBit

Function

Retrieves the status of multiple output bits.

Format

Ret = DioEchoBackMultiBit ( Id , &BitNo[0] , BitNum , &Data[0] )

Parameters

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

BitNo [C:short *] [Python: ctypes.POINTER(ctypes.c_short)]
Retrieves the status of multiple output bits.

BitNum [C:short] [Python: ctypes.c_short]
Specifies the number of bits which are specified by BitNo. The maximum number of bits is 256.

Data [C:unsigned char *] [Python: ctypes.POINTER(ctypes.c_ubyte)]
Specifies the base address of the array to store the output data. Either 0 or 1 are returned that indicate the output data.

Return Value

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

Definition	Value [Dec]	Description
DIO_ERR_SUCCESS	0	Normal complete
DIO_ERR_DLL_INVALID_ID	10001	Invalid ID is 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 function cannot be used for this device.
DIO_ERR_SYS_BIT_NO	20102	Bit number is outside of the available range.
DIO_ERR_SYS_BIT_NUM	20103	BNumber of bits is outside of the available range.

The other errors: (See also: Error code details)

Initial Value

The initial value of the output data is 0, after the device was reset.

Remarks

Retrieves the status of multiple output bits. Before this function is called, it is necessary that the logical output bits to be input numbers are set into the array specified by BitNo.
The data are stored in the array named Data by the order of logical bits which are specified by BitNo.
The output data are returned either 0 or 1.

This function is used for monitoring the outputting contents.

Example

C	Ret = DioEchoBackMultiBit( Id , &BitNo , BitNum , &Data[0] );
Python	Ret = cdio.DioEchoBackMultiBit( Id , BitNo , BitNum , Data )