dio_raw_to_status_text_extended_c

	status.i4.v = dio_raw_to_status_text_extended_c(device_indices.i4a.r,
							raw_data.g.v,
							chars_filled.i4a.r,
							status_text.sa.r,
							errors.i2a.r
							[,num_devices.i4.v]
							[,lengths.i4a.r])

	This routine converts raw basic status data (property PRBSTS) to
	a color coded character string of basic status text.

	device_indices	device index or array of device indices
	raw_data	raw basic status data returned by a previous
			call to dio_get_raw(_c) or dio_get_lst_raw(_c)
	chars_filled	returned array of number of characters actually
			filled for each device
			(A value of NULL can be passed for this argument
			 if this information is not needed.)
	status_text	returned status text
			(array of DIO_MAX_STATUS_SCALING_ENTRIES
			 XCHAR structures containing color coded text for
			 each device)
	errors		returned ACNET status value or array of returned
			status values
	[num_devices]	number of devices in list (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.)
			(default is NULL which results in using the database
			 default/atomic size for each device)

	This function returns status values as follows:

	OK			success
	DIO_MEMFAIL		memory allocation failure
	DIO_INVLEN		an invalid device length was requested for
				one or more devices
	negative value		other ACNET format error
	positive value		number of devices in error

	This function requires the following include files:

	cns_data_structs_h, dbprops_h, diolib_h, acnet_errors_h

	Related functions:

	dio_raw_to_status_text, dio_raw_to_status_extended_c,
	dio_raw_to_status_c, dio_sts_txt(_c),
	dio_status_scaling_info_c, dio_bld_get(_c), dio_sts_txt_lst,
	dio_get_raw(_c), dio_bld_get_raw(_c), dio_get_lst_raw(_c),
	dstatx_ext_c, dstatx, dio_raw_to_scaled_data(_c),
	dio_raw_to_value_text_c, dio_raw_to_scaled_custom_c,
	dio_primary_to_scaled_custom_c, dio_scaled_to_raw_custom_c,
	error_in_list(_c)

	C/C++ usage:

	char	raw_data[TOTAL_LENGTH];
	short	errors[NUM_DEVICES];
	int	status;
	static const int	device_indices[NUM_DEVICES] = {14430, 14431};
	int	chars_filled[NUM_DEVICES];
	int	num_devices = NUM_DEVICES;
	int	*lengths = (int *) NULL;
	XCHAR	status_text[NUM_DEVICES][DIO_MAX_STATUS_SCALING_ENTRIES];

	status = dio_raw_to_status_text_extended_c(device_indices,
						   (void *) raw_data,
						   chars_filled,
						   (XCHAR *) status_text,errors,
						   num_devices,lengths);