dio_get_raw_snapshot_list_c

	status.i4.v = dio_get_raw_snapshot_list_c(list_id.i4.v, num_points.i4.v,
						  points.sa.r, errors.i2a.r
						  [,sample_rates.u4a.r]
						  [,ret_num_point.i4a.r]
						  [,options.u4.v])

	This routine retrieves raw snapshot data for a list of devices that
	were requested by an earlier call to dio_build_snapshot_list_c.
	If this routine successfully returns data, the list should either
	be cancelled by a call to dio_cancel_snapshot_list_c or rearmed
	for another retrieval by a call to dio_rearm_snapshot_list_c.

	list_id		list ID returned from a previous call to
			dio_build_snapshot_list_c
	num_points	number of points to retrieve per device
			(maximum depends on the type of device being plotted)
	points		returned data in time stamp, device value order
			(time stamps are in 100 usec units after the data
			 acquisition trigger event)
			(array of structures of type DIO_RAW_SNAPSHOT_POINT)
	errors		array of ACNET status values
	[sample_rates]	returned data sample rates in Hz (default is NULL)
	[ret_num_point]	returned array of number of valid points per device
	[options]	retrieval options
			(DIO_SNAP_OPT_NONE -> not options selected (default),
			 DIO_SNAP_OPT_INTERPOLATE_TIMES -> interpolate between
							   matching timestamps)

	This function returns status values as follows:

	OK			success
	DIO_MEMFAIL		memory allocation failure
	DIO_NOLIST		requested list does not exist
	DIO_BADARG		invalid number of points 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, cns_data_structs_h, diolib_h, acnet_errors_h

	Related functions:

	dio_build_snapshot_list_c, dio_cancel_snapshot_list_c,
	dio_rearm_snapshot_list_c, dio_get_snapshot_list_c,
	dio_can_read_using_snapshot_c, dio_can_snapshot_c,
	dio_can_trigger_snapshot_c, dio_snapshot_class_info_c,
	dio_get_ftp_list_c, dio_get_raw_ftp_list_c, dio_get_status_ftp_list_c,
	dio_build_ftp_list_c, dio_cancel_ftp_list_c, dio_can_read_using_ftp_c,
	dio_can_ftp_c, dio_ftp_class_info_c, sr_sda_get_snapshot_list_c,
	sr_sda_get_raw_snapshot_list_c, error_in_list(_c)

	C/C++ usage:

	short	errors[NUM_DEVICES];
	int	status;
	int	list_id;
	int	num_points = 2046;
	int	ret_num_point[NUM_DEVICES];
	unsigned int	sample_rates[NUM_DEVICES];
	unsigned int	options = DIO_SNAP_OPT_NONE;
	DIO_RAW_SNAPSHOT_POINT	points[NUM_DEVICES][2046];

	status = dio_get_raw_snapshot_list_c(list_id,num_points,
					     (DIO_RAW_SNAPSHOT_POINT *) points,
					     errors,sample_rates,ret_num_point,
					     options);