dio_memory_status_c

	status.i4.v = dio_memory_status_c(num_devices.i4.v,
					  device_indices.i4a.r,
					  lengths.i2a.r, offsets.i2a.r,
					  on_states.i4a.r, ready_states.i4a.r,
					  remote_states.i4a.r,
					  positive_states.i4a.r,
					  ramp_states.i4a.r, status_text.sa.r,
					  errors.i2a.r [,vals_per_dev.i4a.r]
					  [,options.u4.v])

	This routine returns scaled data from the current DIO memory pool.
	A value of NULL can be passed for any returned argument that is
	not needed.

	num_devices	number of devices requesting data
	device_indices	device indices
	lengths		data lengths in bytes
	offsets		data offsets in bytes 
	on_states	returned on/off status values
			(TRUE -> device was on,
			 FALSE -> device was off,
			 DIO_NOATT -> on/off attribute not defined)
	ready_states	returned ready/tripped status values
			(TRUE -> device was ready,
			 FALSE -> device was tripped,
			 DIO_NOATT -> ready/tripped attribute not defined)
	remote_states	returned remote/local status values
			(TRUE -> device was in remote,
			 FALSE -> device was in local,
			 DIO_NOATT -> remote/local attribute not defined)
	positive_states	returned polarity status values
			(TRUE -> device was in positive polarity,
			 FALSE -> device was in negative polarity,
			 DIO_NOATT -> polarity attribute not defined)
	ramp_states	returned ramp/DC status values
			(TRUE -> device was ramping,
			 FALSE -> device was DC,
			 DIO_NOATT -> ramp/DC attribute not defined)
	status_text	returned DIO_NUM_STATUS_TYPES + 1 characters of XCHAR
			format color coded status text
			(array of XCHAR structures)
	errors		returned device errors
	[vals_per_dev]	returned number of values per device
			(default is NULL)
	[options]	reading options
			(DIO_OPT_NONE -> no options selected (default),
			 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_get_array_c,
	dio_memory_set_populate_c, dio_memory_get_directed_raw_c,
	dio_memory_set_raw_c, dio_memory_set_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:

	short	errors[NUM_DEVICES];
	static const short	lengths[NUM_DEVICES] = {0, 0};
	static const short	offsets[NUM_DEVICES] = {0, 0};
	int	status;
	int	num_devices = NUM_DEVICES;
	static const int	device_indices[NUM_DEVICES] = {14430, 14431};
	int	on_states[NUM_DEVICES];
	int	ready_states[NUM_DEVICES];
	int	remote_states[NUM_DEVICES];
	int	positive_states[NUM_DEVICES];
	int	ramp_states[NUM_DEVICES];
	int	vals_per_dev[NUM_DEVICES];
	unsigned int	options = DIO_OPT_NONE;
	XCHAR	status_text[NUM_DEVICES][DIO_NUM_STATUS_TYPES+1];

	status = dio_memory_status_c(num_devices,device_indices,lengths,offsets,
				     on_states,ready_states,remote_states,
				     positive_states,ramp_states,status_text,
				     errors,vals_per_dev,options);