dio_device_state_c
status.i4.v = dio_device_state_c(num_devices.i4.v,
device_indices.i4a.r,
device_states.i2a.r
[,use_cache.i4.v])
This routine determines whether or not a device index or a
list of device indices are currently valid.
num_devices number of device indices
device_indices device index or array of device indices
device_states returned state or array of returned states
(OK -> this is a valid device index,
DBM_OBSDEV -> this device index has been obsoleted,
DBM_DELDEV -> this device index has been deleted,
DBM_DOCDEV -> this device index points to a
documentation device,
DBM_ILDEV -> this device index does not exist in
the database)
[use_cache] flag indicating whether or not to use cached state
information
(TRUE -> use cached state information,
FALSE -> read state information directly from
the database (default))
This function returns ACNET status values as follows:
OK success
DIO_BADARG invalid number of devices passed
negative value ACNET format error indicating overall failure
This function requires the following include files:
diolib_h, acnet_errors_h
Related functions:
dio_obsolete_info_c, dio_longest_device_obsolete_comment,
dio_documentation_info_c, dio_longest_device_document_comment,
dio_get_dev(_c), dio_set_dev(_c), dio_get_raw(_c),
dio_set_raw(_c), dio_bld_get(_c), dio_bld_set(_c), dio_bld_get_raw(_c),
dio_bld_set_raw(_c)
C/C++ usage:
short device_states[NUM_DEVICES];
int status;
int num_devices = NUM_DEVICES;
int use_cache = FALSE;
static const int device_indices[NUM_DEVICES] = {14430, 14431};
status = dio_device_state_c(num_devices,device_indices,
device_states,use_cache);