sr_snapshot_info_c

	status.i4.v = sr_snapshot_info_c(device_index.i4.v, file_number.i4.v,
					 num_points.i4.r, delta_time.r4.r,
					 start_time.u4.r [,data_source.i4.v]
					 [,case_number.i4.v]
					 [,snapshot_mode.i4.r]
					 [,arm_events.u1a.r] [,arm_delay.i4.r]
					 [,subcase_num.i4.v] [,sda_usage.i1a.r])

	This routine returns information about a snapshot taken by either
	SDA or the detached snapshot manager.

	device_index	device index
	file_number	file number from which to retrieve data
			(This is the subsystem number or user key 1 for
			 detached snapshot manager data.)
	num_points	returned number of available points
			(A value of NULL may be passed for this argument
			 if this value is not needed.)
	delta_time	returned time between points (in milliseconds)
			(A value of NULL may be passed for this argument
			 if this value is not needed.)
	start_time	returned date of beginning of data acquistion
			(in clinks)
			(A value of NULL may be passed for this argument
			 if this value is not needed.)
	[data_source]	source of data
			(SRMNGR_SDA_DATA -> SDA data (default),
			 SRMNGR_SNAP_DATA -> detached snapshot manager data)
	[case_number]	SDA case number  (This is the record number or
			user key 2 for detached snapshot data.)
			(default is SDA_DEFAULT_CASE_NUMBER for SDA data and
			 0 for detached snapshot data)
	[snapshot_mode]	returned snapshot data acquisiton mode
			(DIO_STANDARD_SNAPSHOT_MODE -> data was acquired
			 following arm event and delay,
			 DIO_TRANSIENT_RECORDER_MODE -> data was acquired
			 constantly until "arm_delay" points after the arm
			 event)
			(default is NULL)
	[arm_events]	returned array of 8 clock events to arm data acquisition
			(default is NULL)
	[arm_delay]	returned delay after arm event in milliseconds if
			in DIO_STANDARD_SNAPSHOT_MODE or number of points
			acquired after the arm event in
			DIO_TRANSIENT_RECORDER_MODE
			(default is NULL)
	[subcase_num]	SDA subcase number (This argument only
			has meaning if the data source is SDA.)
			(default is SDA_DEFAULT_SUBCASE_NUMBER)
	[sda_usage]	null terminated SDA usage string (This argument only
			has meaning if the data source is SDA.)
			(default is NULL which results in Collider shot access)

	This function returns status values as follows:

	OK			success
	DIO_BADARG		invalid data source or case number
	DIO_MEMFAIL		memory allocation failure
	DIO_INVLEN		too much data requested

	This function requires the following include files:

	cbslib_h, acnet_errors_h

	Related functions:

	sr_snapshot_header_c, sr_snapshot_info_list_c, sr_get_snapshot_c,
	sr_read_snapshot_c, sr_sda_snapshot_stats_c, sr_snap_directory_info_c,
	sr_snap_date_to_file_info_c, sr_snap_active_devices_c, sr_set_source_c,
	sr_get_device_c, sr_get_device_raw_c, sr_data_length_c,
	sr_sda_cases_present_c, sr_sda_num_subcases_c,
	sr_sda_subcases_present_c, sr_sda_case_times_c, sr_disconnect

	C/C++ usage:

	char	*sda_usage = (char *) NULL;
	unsigned char	arm_events[8];
	int	status;
	int	device_index = 27235;
	int	file_number = 0;
	int	num_points;
	int	data_source = SRMNGR_SDA_DATA;
	int	case_number = SDA_DEFAULT_CASE_NUMBER;
	int	subcase_num = SDA_DEFAULT_SUBCASE_NUMBER;
	int	snapshot_mode;
	int	arm_delay;
	unsigned int	start_time;
	float	delta_time;

	status = sr_snapshot_info_c(device_index,file_number,&num_points,
				    &delta_time,&start_time,data_source,
				    case_number,&snapshot_mode,
				    arm_events,&arm_delay,subcase_num,
				    sda_usage);