dio_status_scaling_info_c

	status.i4.v = dio_status_scaling_info_c(device_indices.i4a.r,
						num_entries.i4a.r,
						status_entries.sa.r,
						errors.i2a.r
						[,max_return.i4.v]
						[,num_devices.i4.v])

	This routine returns status scaling information for a device or a
	list of devices.  The number of status entries per device 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, status scaling information for a
	list of devices can be retrieved.

	device_indices	device index or array of device indices
	num_entries	returned number of status scaling entries or
			array of number of status scaling entries (A value of
			NULL may be passed if no entry counts are needed.)
	status_entries	returned array of corresponding status scaling entries
			(array of structures of type DIO_STATUS_SCALING_ENTRY)
			(A value of NULL may be passed if no actual status
			 scaling entries are needed.)
	errors		returned ACNET status value or array of status values
	[max_return]	maximum number of status scaling entries to return
			per device
			(default is DIO_MAX_STATUS_SCALING_ENTRIES 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, acnet_errors_h

	Related functions:

	dio_status_scaling_attributes_c, dio_is_status_attribute_value_c,
	dio_is_status_attribute_state_value_c,
	dio_is_status_attribute_value_list,
	dio_is_status_attribute_value_by_id_c,
	dio_build_status_attribute_value_list_c,
	dio_raw_to_status_attribute_value_by_id_c,
	dio_raw_to_status_state_value_by_id_c,
	dio_find_status_scaling_attr_id_c,
	dio_find_status_scaling_attribute_c,
	dio_find_status_scaling_by_attr_id_c,
	dio_find_status_scaling_by_state_c,
	dio_find_status_scaling_by_mask_c, dio_pdb_sts, dio_get_pdb,
	dio_scaling, dio_status(_c), dio_sts_lst, dio_get_raw(_c),
	dio_get_lst_raw(_c), error_in_list(_c)

	C/C++ usage:

	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_STATUS_SCALING_ENTRY	status_entries[NUM_DEVICES*MAX_ENTRIES];

	status = dio_status_scaling_info_c(device_indices,num_entries,
					   status_entries,errors,max_return,
					   num_devices);