dio_build_snapshot_list_c

	status.i4.v = dio_build_snapshot_list_c(list_id.i4.r, num_devices.i4.v,
						device_indices.i4a.r,
						properties.i2a.r, period.r8.v,
						trigger_events.i1a.r,
						num_events.i4.v, delay.i4.v,
						errors.i2a.r [,read_mode.i4.v]
						[,sample_events.i1a.r]
						[,wait_for.i4.v]
						[,num_points.i4.v])

	This routine builds a request for snapshot data for a list of
	devices.  This data can be retrieved by a subsequent call to
	dio_get_snapshot_list_c.

	list_id		returned list ID (used to retrieve data)
	num_devices	number of devices in list
	device_indices	list of device indices
	properties	list of property indices (If the first value is less
			than zero, all devices will be submitted with the
			same property.  The property value used will be the
			absolute value of this argument.)
			(constants are in dbprops)
	period		data acquisition period in seconds
			(If a negative value is entered, this value is
			 interpreted as a frequency in Hz.)
	trigger_events	array of up to 8 clock events to trigger data
			acquisition (constants are in tclk_events)
	num_events	number of trigger events (up to 8)
	delay		delay after trigger event in milliseconds if
			in DIO_STANDARD_SNAPSHOT_MODE or number of points
			to acquire after the trigger event in
			DIO_TRANSIENT_RECORDER_MODE
	errors		array of returned ACNET status values
	[read_mode]	type of data acquisition
			(DIO_STANDARD_SNAPSHOT_MODE -> data is acquired
			 following trigger event and delay (default),
			 DIO_TRANSIENT_RECORDER_MODE -> data is acquired
			 constantly until "delay" points after the trigger
			 event)
	[sample_events]	8 clock events which will be used to sample data
			(default is NULL which results in sampling all points)
			(constants are in tclk_events)
	[wait_for]	wait for reply from FTP manager flag
			(TRUE -> wait for response from FTP manager,
			 FALSE -> return immediately (default))
	[num_points]	number of points to retrieve
			(maximum depends on the type of device being plotted)
			(The default value is zero, which results in
			 retrieving the maximum number of points possible.)

	This function returns status values as follows:

	OK			success
	DIO_MEMFAIL		memory allocation failure
	DIO_BADARG		invalid period, delay, or number of devices
	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, diolib_h, acnet_errors_h, tclk_events_h

	Related functions:

	dio_get_snapshot_list_c, dio_get_raw_snapshot_list_c,
	dio_cancel_snapshot_list_c, dio_rearm_snapshot_list_c,
	dio_can_read_using_snapshot_c, dio_can_snapshot_c,
	dio_can_trigger_snapshot_c, dio_snapshot_class_info_c,
	dio_build_ftp_list_c, dio_get_ftp_list_c, dio_get_raw_ftp_list_c,
	dio_get_status_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:

	char	trigger_events[NUM_EVENTS] =
		{EVENT_RESET_PBAR_INJ, EVENT_TEV_RESET_FIXED_TARG};
	char	*sample_events = (char *) NULL;
	short	properties = -PRREAD;
	short	errors[NUM_DEVICES];
	int	status;
	int	list_id;
	int	num_devices = NUM_DEVICES;
	static const int	device_indices[NUM_DEVICES] = {7085, 7046};
	int	num_events = NUM_EVENTS;
	int	delay = 0;
	int	read_mode = DIO_STANDARD_SNAPSHOT_MODE;
	int	wait_for = TRUE;
	int	num_points = 0;
	double	period = 1.0;

	status = dio_build_snapshot_list_c(&list_id,num_devices,
					   device_indices,&properties,
					   period,trigger_events,num_events,
					   delay,errors,read_mode,
					   sample_events,wait_for,num_points);