dio_memory_get_array_c

	status.i4.v = dio_memory_get_array_c(num_devices.i4.v,
					     device_indices.i4a.r,
					     properties.i2a.r,
					     num_elements.i4a.r,
					     start_elements.i2a.r, values.r4a.r,
					     units_text.i1a.r, errors.i2a.r,
					     values_per_dev.i4a.r, options.u4.v)

	This routine returns scaled data from the current DIO memory pool.

	num_devices	number of devices requesting data
	device_indices	device index or array of device indices
	properties	property index or array of property indices
			(If the first value is less than zero, all devices
			 will be requested with a property index which is
			 equal to the absolute value of this argument.)
			(constants are in 'dbprops')
			(PRREAD -> reading property,
			 PRSET -> setting property)
	num_elements	array of number of array elements to return (>= 1)
			(Note: If the first value is less than zero, all
			 devices will be submitted with the number of elements
			 requested equal to the absolute value of that value.)
			(If a value of NULL is passed for this argument,
			 a single value for each device will be returned.)
	start_elements	array of first elements to return (starting at 0)
			(Note: If the first value is less than zero, all
			 devices will be submitted with the starting element
			 requested equal to the absolute value of that value.)
			(If a value of NULL is passed for this argument,
			 an offset of 0 will be used for each device.)
	values		returned scaled values
	units_text	returned units text
			(LEN_DEV_UNITS characters per device)
			(If a value of NULL is passed for this arguemnt,
			 no units text will be returned.)
	errors		returned device errors
	values_per_dev	returned number of values per device
			(A value of NULL can be passed for this argument if
			 this information is not needed.)
	options		reading options
			(DIO_OPT_NONE -> no options selected,
			 DIO_OPT_NO_POPULATE -> don't autopopulate the memory
						pool during this read)

	This function returns ACNET status values as follows:

	OK			success
	negative value		overall ACNET error
	positive value		number of devices in error

	This function requires the following include files:

	dbprops_h, diolib_h, acnet_errors_h

	Related functions:

	dio_memory_get_c, dio_memory_get_raw_c, dio_memory_read_c,
	dio_memory_read_raw_c, dio_memory_set_populate_c,
	dio_memory_get_directed_raw_c, dio_memory_set_raw_c,
	dio_memory_set_c, dio_memory_write_c, dio_memory_set_array_c,
	dio_memory_control_c, dio_memory_cancel_c, dio_memory_populate_c,
	dio_memory_populate_query, dio_memory_pool_name_to_id_c,
	error_in_list(_c)

	C/C++ usage:

	char	units[NUM_DEVICES][LEN_DEV_UNITS];
	short	errors[NUM_DEVICES];
	static const short	properties[NUM_DEVICES] = {PRSET, PRSET};
	int	status;
	int	num_devices = NUM_DEVICES;
	static const int	device_indices[NUM_DEVICES] = {14430, 14431};
	static const int	num_elements[NUM_DEVICES] = {1, 1};
	static const int	start_elements[NUM_DEVICES] = {0, 0};
	int	values_per_dev[NUM_DEVICES];
	unsigned int	options = 0;
	float	values[NUM_DEVICES];

	status = dio_memory_get_array_c(num_devices,device_indices,properties,
					num_elements,start_elements,values,
					(char *) units_text,errors,
					values_per_dev,options);