sr_sda_get_device_over_time_c

	status.i4.v = sr_sda_get_device_over_time_c(device_index.i4.v,
						    property.i2.v,
						    sda_usage.i1a.r,
						    search_type.i4.v,
						    search_info.g.v,
						    case_info.s.r,
						    set_info.s.r,
						    options.u4.v,
						    num_points.i4.r,  
						    values.r8p.r,
						    value_data.sp.r,
						    [,vals_per_point.i4.r]
						    [,raw_length.i4.v]
						    [,raw_offset.i4.v]
						    [,units_text.i1a.r])

	This routine returns scaled data that has been previously saved by
	the SDA system.  It returns data from a group of samples with the
	data in time order.

	device_index	device index
	property	property index
			(constants are in dbprops)
	sda_usage	null terminated SDA usage string
			(If a value of NULL is passed for this argument,
			 a value of 'ColliderShot' will be used.)
	search_type	type of file search
			(SRMNGR_SEARCH_BY_ALL -> search all files,
			 SRMNGR_SEARCH_BY_FILE_NUMBER -> search by file number,
			 SRMNGR_SEARCH_BY_DATE -> search by date)
	search_info	search information which depends on "search_type"
			(SRMNGR_SEARCH_BY_ALL -> argument is unused,
			 SRMNGR_SEARCH_BY_FILE_NUMBER -> structure of type
							 SRMNGR_SEARCH_BY_FILE_DATA,
			 SRMNGR_SEARCH_BY_DATE -> structure of type
						  SRMNGR_SEARCH_BY_DATE_DATA)
	case_info	case search limits
			(structure of type SRMNGR_SEARCH_SDA_CASE_DATA)
			(If a value of SRMNGR_SEARCH_SDA_DEVICE_CASES is
			 passed for the minimum case number, only cases
			 currently configured to retrieve this device
			 will be searched.)
			(Note: Passing a value of NULL will result in a
			 search including all cases.)
	set_info	set search limits
			(structure of type SRMNGR_SEARCH_SDA_SET_DATA)
			(Note: Passing a value of NULL will result in a
			 search including all sets.)
	options		retrieval options (currently unused)
	num_points	returned number of saved points found
	values		returned scaled device data  (Note: This is a pointer
			to a buffer allocated by this routine. The caller should
			neither allocate or free this buffer.)
	value_data	returned value data (pointer to an array of
			structures of type SRMNGR_SDA_SEARCH_VALUE_DATA)
			(Note: This is a pointer to a buffer allocated by
			 this routine. The caller should neither allocate
			 or free this buffer.)
	[vals_per_point]returned number of values per entry (default is NULL)
	[length]	raw device length (default is 0 which results in
			using the database default size for each device)
	[offset]	raw data offset or array of data offsets in bytes
			(default is 0)
	[units_text]	units text (LEN_DEV_UNITS characters)
			(default is NULL)

	This function returns status values as follows:

	OK			success
	DIO_MEMFAIL		memory allocation failure
	DIO_INVLEN		too much data requested
	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, dbprops_h, cbslib_h, acnet_errors_h

	Related functions:

	sr_set_source_c, sr_sda_get_device_over_time_raw_c,
	sr_sda_get_status_text_over_time_c, sr_get_device_over_time_c,
	sr_get_device_over_time_raw_c, sr_get_status_text_over_time_c,
	sr_get_device_c, sr_get_device_raw_c, sr_sda_data_lengths_c,
	sr_status_c, sr_status_text_c, sr_is_on_c, sr_is_positive_c,
	sr_sda_snapshot_stats_c, sr_snapshot_header_c, sr_snapshot_info_c,
	sr_snapshot_info_list_c, sr_get_snapshot_c, sr_read_snapshot_c,
	sr_disconnect, sr_get_array_device_c, sr_sda_cases_present_c,
	sr_sda_num_subcases_c, sr_sda_subcases_present_c, sr_sda_case_times_c

	C/C++ usage:

	static const char	sda_usage[] = "ColliderShot";
	char	units_text[LEN_DEV_UNITS];
	short	property = PRREAD;
	int	status;
	int	device_index = 27235;
	int	search_type = SRMNGR_SEARCH_BY_DATE;
	int	num_points;
	int	values_per_point;
	int	length = 2;
	int	offset = 0;
	unsigned int	options = 0;
	double	*values;
	SRMNGR_SEARCH_BY_DATE_DATA	search_info;
	SRMNGR_SEARCH_SDA_CASE_DATA	*case_info = (SRMNGR_SEARCH_SDA_CASE_DATA *) NULL;
	SRMNGR_SEARCH_SDA_SET_DATA	*set_info = (SRMNGR_SEARCH_SDA_SET_DATA *) NULL;
	SRMNGR_SDA_SEARCH_VALUE_DATA	*value_data;

	status = sr_sda_get_device_over_time_c(device_index,property,sda_usage,
					       search_type,
					       (void *) &search_info,
					       case_info,set_info,
					       options,&num_points,
					       (void **) &values,&value_data,
					       &vals_per_point,length,offset,
					       units_text);
-