dio_enum_value_info_c

	status.i4.v = dio_enum_value_info_c(device_indices.i4a.r,
					    properties.i2a.r,
					    num_entries.i4a.r,
					    enum_entries.sa.r,
					    errors.i2a.r
					    [,max_return.i4.v]
					    [,num_devices.i4.v])

	This routine returns reading/setting enumerated value information
	for a device.  The number of enumerated entries is returned in
	"num_entries".  If "max_entries" is specified, the number of
	entries per device returned will be limited to that number.
	"num_entries", however, will always contain the number of entries
	in the database for the corresponding device.  If "num_devices"
	is specified, enumerated value information for a list of devices
	can be retrieved.

	device_indices	device index or array of device indices
	properties	property index or array of property indices
			(PRREAD -> reading property,
			 PRSET -> setting property)
			(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.)
	num_entries	returned number of enumerated value entries or
			array of number of enumerated entries (A value of
			NULL may be passed if no entry counts are needed.)
	enum_entries	returned array of corresponding enumerated value
			entries (array of structures of type
			DIO_ENUM_VALUE_ENTRY) (A value of NULL may be
			passed if no actual enumerated value entries are
			needed.)
	errors		returned ACNET status value or array of status values
	[max_return]	maximum number of enumerated value entries to return
			per device (default is 256 entries)
	[num_devices]	number of devices (default is 1)

	This function returns status values as follows:

	OK			success
	DIO_BADARG		invalid number of devices passed
	DIO_MEMFAIL		memory allocation failure
	negative value		ACNET format error indicating overall failure
	positive value		number of devices in error indicating partial
				success

	This function requires the following include files:

	cnsparam_h, diolib_h, cns_data_structs_h, acnet_errors_h

	Related functions:

	dio_has_enum_value_info_c, dio_is_enum_value_info_shared_c,
	dio_enum_value_shared_devices_c, dio_get_pdb, dio_scaling,
	dio_get_dev(_c), dio_get_lst, dio_set_dev(_c), dio_set_lst,
	dio_raw_to_enum_value_text_c, dio_enum_value_text_to_raw_data_c,
	error_in_list(_c)

	C/C++ usage:

	static const short	properties[NUM_DEVICES] = {PRREAD, PRREAD};
	short	errors[NUM_DEVICES];
	int	status;
	static const int	device_indices[NUM_DEVICES] = {14430, 14431};
	int	num_entries[NUM_DEVICES];
	int	max_return = MAX_ENTRIES;
	int	num_devices = NUM_DEVICES;
	DIO_ENUM_VALUE_ENTRY	enum_entries[NUM_DEVICES*MAX_ENTRIES];

	status = dio_enum_value_info_c(device_indices,properties,num_entries,
				       enum_entries,errors,max_return,
				       num_devices);