dio_ssdn_to_snapshot_class_c
status.i4.v = dio_ssdn_to_snapshot_class_c(ssdns.i1a.r, nodes.i4a.r,
properties.i2a.r,
num_devices.i4.v,
errors.i2a.r
[,snap_classes.i4a.r])
This routine returns the snapshot class for a device or a list of
devices based upon their SSDNs.
ssdns SubSystem Device Number (SSDN) or array of SSDNs
nodes ACNET node or array of ACNET nodes
(constants are in 'nodedefs')
properties property index or array of indices
(If the first value is less than zero, all devices
will be requested with a property index which is
equal to the absolute value of this argument.)
(constants are in 'dbprops')
num_devices number of devices
errors returned error status or array of errors
[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:
diolib_h, nodedefs_h, ftp_h, acnet_errors_h
Related functions:
dio_get_snapshot_class_c, dio_can_snapshot_c,
dio_can_read_using_snapshot_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_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 ssdns[NUM_DEVICES][LEN_SSDN];
static const short properties[NUM_DEVICES] = {PRREAD, PRREAD};
short errors[NUM_DEVICES];
int status;
static const int nodes[NUM_DEVICES] = {MI, PBAR};
int num_devices = NUM_DEVICES;
int snap_classes[NUM_DEVICES];
status = dio_ssdn_to_snapshot_class_c(ssdns,nodes,properties,
num_devices,errors,snap_classes);