dio_status_attr_to_bit_info_c

	status.i4.v = dio_status_attr_to_bit_info_c(device_indices.i4a.r,
						    status_attr.i4.v,
						    num_entries.i4a.r,
						    bit_numbers.i4p.r,
						    text_if_0.i1p.r,
						    color_if_0.i4p.r,
						    text_if_1.i1p.r,
						    color_if_1.i4p.r,
						    text.i1p.r, errors.i2a.r
						    [,num_devices.i4.v])

	This routine returns bit information for a device corresponding
	to a specified status attribute.  The number of bit entries
	is returned in "num_entries".  The short text strings and their
	colors for bit states 0 and 1 are returned in "text_if_x" and
	"color_if_x" respectively.  The status bit number corresponding
	to the text is returned in "bit_numbers", and the descriptive
	text is returned in "text".  If "num_devices" is specified,
	bit information for a list of devices can be retrieved.
	All returned arrays are allocated by this routine and should be
	freed by the caller.

	device_indices	device index or array of device indices
	status_attr	desired status attribute
			(DIO_STS_MSK_ONOFF -> on/off attribute,
			 DIO_STS_MSK_READYTRIPPED -> ready/tripped attribute,
			 DIO_STS_MSK_REMOTELOCAL -> remote/local attribute,
			 DIO_STS_MSK_POLARITY -> polarity attribute,
			 DIO_STS_MSK_RAMPDC -> ramp/DC attribute)
	num_entries	returned number of extended text entries or array of
			number of text entries (A value of NULL may be passed
			if no entry counts are needed.)
	bit_numbers	returned array of corresponding basic status bit
			numbers (values start at 0) (A value of NULL may be
			passed if no bit numbers are needed.)
	text_if_0	returned condition text if bit is 0
			(DIO_COND_EXT_TEXT_LEN characters per entry)
			(A value of NULL may be passed if no text is needed.)
	color_if_0	returned color code if bit is 0
			(constants are in 'cnsparam') (A value of NULL may
			be passed if no colors are needed.)
	text_if_1	returned condition text if bit is 1
			(DIO_COND_EXT_TEXT_LEN characters per entry)
			(A value of NULL may be passed if no text is needed.)
	color_if_1	returned color code if bit is 1
			(constants are in 'cnsparam') (A value of NULL may be
			passed if no colors are needed.)
	text		returned descriptive text
			(DIO_EXT_TEXT_LEN characters plus a null terminator
			 per entry)
			(A value of NULL may be passed if no text is needed.)
	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 or
				status attribute 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_pdb_sts, dio_ext_text(_c), error_in_list(_c)

	C/C++ usage:

	char	*text_if_0;
	char	*text_if_1;
	char	*text;
	short	errors[NUM_DEVICES];
	int	status;
	static const int	device_indices[NUM_DEVICES] = {14430, 14431};
	int	status_attr = DIO_STS_MSK_ONOFF;
	int	num_entries[NUM_DEVICES];
	int	*bit_numbers;
	int	*color_if_0;
	int	*color_if_1;
	int	num_devices = NUM_DEVICES;

	status = dio_status_attr_to_bit_info_c(device_indices,status_attr,
					       num_entries,&bit_numbers,
					       &text_if_0,&color_if_0,
					       &text_if_1,&color_if_1,&text,
					       errors,num_devices);
				.
				.
				.
	free(bit_numbers);
	free(text_if_0);
	free(color_if_0);
	free(text_if_1);
	free(color_if_1);
	free(text);