dio_can_snapshot_c
status.i4.v = dio_can_snapshot_c(device_indices.i4a.r,
can_snapshots.i4a.r, errors.i2a.r
[,num_devices.i4.v]
[,snap_classes.i4a.r])
This routine determines whether or not a device or a list of
devices can be read as a snapshot buffer of values. Please,
note that this routine only returns information for the
reading properties of the requested devices.
device_indices device index or array of device indices
can_snapshots returned snapshot capability or array of returned
capabilities
(TRUE -> device can be read via a snapshot,
FALSE -> device cannot be read via a snapshot,
DIO_INVALID_DATA -> error occurred in reading data)
errors returned error status or array of errors
[num_devices] number of devices (default is 1)
[snap_classes] returned snapshot class code(s) (constants are in 'ftp')
(default is NULL)
This function returns ACNET status values as follows:
OK success
DIO_MEMFAIL memory allocation failure
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, diolib_h, ftp_h, acnet_errors_h
Related functions:
dio_can_read_using_snapshot_c, dio_get_snapshot_class_c,
dio_can_trigger_snapshot_c, dio_snapshot_class_info_c,
dio_build_snapshot_list_c, 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_ftp_c, dio_can_ftp_c,
dio_get_ftp_class_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;
static const int device_indices[NUM_DEVICES] = {7085, 7046};
int can_snapshots[NUM_DEVICES];
int num_devices = NUM_DEVICES;
int snap_classes[NUM_DEVICES];
status = dio_can_snapshot_c(device_indices,can_snapshots,errors,
num_devices,snap_classes);