dio_build_status_attribute_value_list_c

	status.i4.v = dio_build_status_attribute_value_list_c(list_id.i4.r,
							      num_devices.i4.v,
							      device_indices.i4a.r,
							      errors.i2a.r
							      [,data_event.i1a.r]
							      [,num_elements.i4a.r]
							      [,start_elements.i4a.r])

	This routine builds a list of requests for status devices for
	later retrieval with dio_is_status_attribute_value_list.

	list_id		returned list ID for subsequent use by
			dio_is_status_attribute_value_list
	num_devices	number of devices
	device_indices	device index array
	errors		array of returned ACNET status values
			(one for each device in the list)
	[data_event]	data event on which data is collected
			(default is NULL (one shot))
	[num_elements]	array of number of array elements to return (>= 1)
			(Note: If the first value is less than zero, all
			 devices will be submitted with the number of elements
			 requested equal to the absolute value of that value.)
			(If a value of NULL is passed for this argument,
			 one element for each device will be returned.)
	[start_elements] array of first elements to return (starting at 0)
			 (Note: If the first value is less than zero, all
			  devices will be submitted with the starting element
			  requested equal to the absolute value of that value.)
			 (If a value of NULL is passed for this argument,
			  a starting element of 0 will be used for each device.)

	This function returns status values as follows:

	OK			success
	DIO_MEMFAIL		memory allocation failure
	DIO_INVDEV		at least one entry is not a valid array device
	DIO_BADARG		invalid number of elements or starting element
	negative value		other ACNET format error
	positive value		number of devices in error

	This function requires the following include files:

	diolib_h, acnet_errors_h

	Related functions:

	dio_is_status_attribute_value_list, dio_is_status_attribute_value_c,
	dio_is_status_attribute_state_value_c,
	dio_is_status_attribute_value_by_id_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_state_c,
	dio_find_status_scaling_by_mask_c,
	dio_raw_to_status_attribute_value_by_id_c,
	dio_raw_to_status_state_value_by_id_c, dio_bld_get_raw(_c),
	dio_sts_lst, dio_status(_c), dio_sts_txt_lst, dio_sts_txt(_c),
	dio_is_on_lst, dio_is_on(_c), dio_is_rdy_lst, dio_is_ready(_c),
	dio_is_rem_lst, dio_is_remote(_c), dio_is_pos_lst, dio_is_positive(_c),
	dio_is_ramping_list_c, dio_is_ramping_c, dio_bld_get(_c),
	dio_get_device_list_c, dio_get_lst, dio_get_directed_list,
	dio_build_get_array_list_c, dio_build_get_array_list_raw_c,
	dio_can_get_lst, error_in_list(_c)

	C/C++ usage:

	static const char	data_event[] = "i";
	short		errors[NUM_DEVICES];
	int		status;
	int		list_id;
	int		num_devices = NUM_DEVICES;
	static int	device_indices[NUM_DEVICES] = {14430, 14431};
	static int	num_elements[NUM_DEVICES] = {1, 1};
	static int	start_elements[NUM_DEVICES] = {0, 0};

	status = dio_build_status_attribute_value_list_c(&list_id,num_devices,
							 device_indices,
							 errors,data_event,
							 num_elements,
							 start_elements);