dio_get_control_value_c

	status.i4.v = dio_get_control_value_c(device_indices.i4a.r,
					      command.i4.v, control_value.u4a.r,
					      errors.i2a.r, num_devices.i4.v)

	This routine returns the setting value for a requested basic
	control command.

	device_indices	array of device indices to check
	command		basic control command
			(DIO_RESET_COMMAND -> reset a device
			 DIO_ON_COMMAND -> turn on a device,
			 DIO_OFF_COMMAND -> turn off a device,
			 DIO_POS_COMMAND -> positive polarity,
			 DIO_NEG_COMMAND -> negative polarity,
			 DIO_RAMP_COMMAND -> ramp mode,
			 DIO_DC_COMMAND -> DC mode)
	control_value	returned array of control values
	errors		returned ACNET status value or array of returned
			status values (A status of DBM_NOREC indicates that
			the requested basic control PDB does not exist.)
	num_devices	number of devices

	This function returns status values as follows:

	OK			success
	DIO_BADARG		invalid number of devices or command passed
	negative value		ACNET format error indicating overall failure
	positive value		number of devices in error

	This function requires the following include files:

	cnsparam_h, diolib_h, acnet_errors_h

	Related functions:

	dio_pdb_ctl, dio_cntrl_dev(_c), dio_cntrl_lst, dio_reset, dio_rst_lst,
	dio_on, dio_on_lst, dio_off, dio_off_lst, dio_positive, dio_pos_lst,
	dio_negative, dio_neg_lst, dio_set_ramp_mode_c,
	dio_set_ramp_mode_list_c, dio_set_dc_mode_c, dio_set_dc_mode_list_c,
	error_in_list(_c)

	C/C++ usage:

	short	errors[NUM_DEVICES];
	int	status;
	static const int	device_indices[NUM_DEVICES] = {4976, 4984};
	int	command = DIO_OFF_COMMAND;
	int	num_devices = NUM_DEVICES;
	unsigned int	control_value[NUM_DEVICES];

	status = dio_get_control_value_c(device_indices,command,control_value,
					 errors,num_devices);