dio_find_status_scaling_by_state_c

	status.i4.v = dio_find_status_scaling_by_state_c(device_indices.i4a.r,
							 state_string.i1a.r,
							 status_entries.sa.r,
							 is_match.i4a.r,
							 errors.i2a.r
							 [,num_devices.i4.v])

	This routine finds a status scaling attribute for a device or a list
	of devices corresponding to a state string.

	device_indices	device index or array of device indices
	state_string	desired null terminated state string
	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.)
	is_match	returned array of flags indicating whether or not the
			match string was the one found
			(TRUE -> found match string,
			 FALSE -> found nonmatch string)
	errors		returned ACNET status value or array of status values
	[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_find_status_scaling_attribute_c, dio_find_status_scaling_attr_id_c,
	dio_find_status_scaling_by_attr_id_c,
	dio_find_status_scaling_by_mask_c, dio_status_scaling_info_c,
	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, error_in_list(_c)

	C/C++ usage:

	static const char	state_string[] = "On";
	short	errors[NUM_DEVICES];
	int	status;
	static const int	device_indices[NUM_DEVICES] = {14430, 14431};
	int	is_match[NUM_DEVICES];
	int	num_devices = NUM_DEVICES;
	DIO_STATUS_SCALING_ENTRY	scaling_entries[NUM_DEVICES];

	status = dio_find_status_scaling_by_state_c(device_indices,state_string,
						    scaling_entries,is_match,
						    errors,num_devices);