dio_raw_to_status_state_value_by_id_c

	status.i4.v = dio_raw_to_status_state_value_by_id_c(device_index.i4.v,
							    raw_data.g.v,
							    attribute_id.i4.v,
							    want_match.i4.v,
							    attr_status.i4.r,
							    errors.i2a.r
							    [,num_devices.i4.v]
							    [,lengths.i4a.r])

	This routine converts raw device data to a status state value
	specified by an attribute ID.

	device_indices	device index or array of device indices
	raw_data	raw basic status data to scale
	attribute_id	desired scaling attribute ID
	want_match	desired state value
			(TRUE -> return state matching status mask value,
			 FALSE -> return state not matching status mask value)
	attr_status	returned attribute status value or array of
			status values
			(TRUE -> device is in the attribute state,
			 FALSE -> device is not in the attribute state,
			 DIO_NOATT -> attribute is not defined)
			(need to provide "num_elements" values)
	errors		array of returned ACNET status values
			(one for each device)
	[num_devices]	number of devices
			(default is 1)
	[lengths]	device length or array of lengths for support of
			array devices  (If the first value is less than zero,
			all devices will use a length which is equal to the
			absolute value of this argument.)
			(Passing a value of NULL results in using the database
			 minimum size for each device.)
			(default is NULL)

	This function returns status values as follows:

	OK			success
	DIO_NO_SUCH		no status scaling information found
	DIO_NOATT		requested attribute not found
	negative value		ACNET format error

	This function requires the following include files:

	cnsparam_h, diolib_h, acnet_errors_h

	Related functions:

	dio_raw_to_status_attribute_value_by_id_c,
	dio_is_status_attribute_value_by_id_c, dio_is_status_attribute_value_c,
	dio_is_status_attribute_state_value_c,
	dio_is_status_attribute_value_list,
	dio_build_status_attribute_value_list_c, dio_status_scaling_info_c,
	dio_status_scaling_attributes_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_mask_c,
	dio_find_status_scaling_by_state_c, dio_pdb_sts, dio_get_pdb,
	dio_is_on(_c), dio_is_ready(_c), dio_is_remote(_c),
	dio_is_positive(_c), dio_status(_c), dio_sts_lst, dio_get_raw(_c)

	C/C++ usage:

	char	raw_data[TOTAL_LENGTH];
	short	errors[NUM_DEVICES];
	int	status;
	static int	device_indices[NUM_DEVICES] = {14430, 14431};
	int	attribute_id = 1;
	int	want_match = TRUE;
	int	attr_status[NUM_DEVICES];
	int	num_devices = NUM_DEVICES;
	int	*lengths = (int *) NULL;

	status = dio_raw_to_status_state_value_by_id_c(device_indices,
						       raw_data,
						       attribute_id,
						       want_match,
						       attr_status,
						       errors,num_devices,
						       lengths);