dio_get_status_array_device_c

	status.i4.v = dio_get_status_array_device_c(device_index.i4.v,
						    on.i4a.r, ready.i4a.r,
						    remote.i4a.r,
						    positive.i4a.r,
						    status_text.sa.r,
						    ftd.i2.v,
						    num_elements.i4.v,
						    start_element.i4.v
						    [,ramping.i4a.r]
						    [,ret_ramp_dc.i4.v])

	This routine retrieves basic status for a single array device.
	The status fields are not boolean.  If a given attribute is not
	defined, a value of DIO_NOATT is returned.  If any of the returned
	parameters are not needed, a value of NULL can be passed for that
	argument.

	device_index	device index
	on		returned array of on/off status values
			(TRUE -> device is on,
			 FALSE -> device is off,
			 DIO_NOATT -> on/off attribute is not defined)
	ready		returned array of ready/tripped status values
			(TRUE -> device is ready,
			 FALSE -> device is tripped,
			 DIO_NOATT -> ready/tripped attribute is not defined)
	remote		returned array of remote/local status values
			(TRUE -> device is in remote,
			 FALSE -> device is in local,
			 DIO_NOATT -> remote/local attribute is not defined)
	positive	returned array of polarity status values
			(TRUE -> device is in positive mode,
			 FALSE -> device is in negative mode,
			 DIO_NOATT -> polarity attribute is not defined)
	status_text	returned DIO_NUM_STATUS_TYPES characters of XCHAR
			format color coded status text per entry
			(array of XCHAR structures)
			(Note: If the value of "ret_ramp_dc" is TRUE,
			 there will be DIO_NUM_STATUS_TYPES + 1 characters
			 of XCHAR format color coded status text per entry.)
	ftd		frequency/time that data is collected
			(FTD_ONESHOT -> one shot,
			 FTD_DEFAULT -> use database default FTD,
			 FTD_1HZ -> 1 Hz request,
			 FTD_EVENT_MASK OR'ed with TCLK event value -> read
			 on TCLK event (event constants are in 'tclk_events')
			 (can use the macro BUILD_EVENT_FTD(event) or
			  BUILD_EVENT_PLUS_DELAY_FTD(event,delay) in 'macro'))
	num_elements	number of array elements to return
	start_element	first element to return (starts at 0)
	[ramping]	returned array of ramp/DC status values
			(TRUE -> device is ramping,
			 FALSE -> device is DC,
			 DIO_NOATT -> ramp/DC attribute is not defined)
	[ret_ramp_dc]	flag which indicates whether or not to return ramp/DC
			attribute text
			(TRUE -> return ramp/DC attribute text,
			 FALSE -> don't return ramp/DC attribute text
				  (default))

	This function returns ACNET status values as follows:

	OK			success
	DIO_BADARG		invalid number of arguments passed
	negative value		ACNET format error

	This function requires the following include files:

	cnsparam_h, cns_data_structs_h, diolib_h, acnet_errors_h, tclk_events_h, macro_h

	Related functions:

	dio_status(_c), dio_sts_lst, dio_sts_txt(_c), dio_raw_to_status_c,
	dio_raw_to_status_extended_c, dio_raw_to_status_text,
	dio_raw_to_status_text_extended_c, dio_is_on(_c), dio_is_ready(_c),
	dio_is_remote(_c), dio_is_positive(_c)

	C/C++ usage:

	short	ftd = FTD_ONESHOT;
	int	status;
	int	device_index;
	int	on[NUM_ELEMENTS];
	int	ready[NUM_ELEMENTS];
	int	remote[NUM_ELEMENTS];
	int	positive[NUM_ELEMENTS];
	int	ramping[NUM_ELEMENTS];
	int	num_elements = NUM_ELEMENTS;
	int	start_element = START_ELEMENT;
	int	ret_ramp_dc = FALSE;
	XCHAR	status_text[NUM_ELEMENTS][DIO_NUM_STATUS_TYPES];

	status = dio_get_status_array_device_c(device_index,on,ready,
					       remote,positive,
					       (XCHAR *) status_text,
					       ftd,num_elements,start_element,
					       ramping,ret_ramp_dc);