dio_change_ftd_lst(_c)
status.i4.v = dio_change_ftd_lst(list_id.i4.r, ftd.i2.r, errors.i2a.r)
status.i4.v = dio_change_ftd_lst_c(list_id.i4.v, ftd.i2.v, errors.i2a.r)
This routine changes the Frequency Time Descriptor (FTD) for a
list of devices previously built via a call to dio_bld_get(_c)
or dio_bld_get_raw(_c).
list_id list ID returned from a previous call to
'dio_bld_get(_raw)(_c)'
ftd Frequency Time Descriptor
(FTD_ONESHOT -> one shot,
FTD_DEFAULT -> use database default FTD,
FTD_1HZ -> 1 Hz request (Note: This value can be
multiplied by an integer constant to
retrieve data every "constant" seconds.),
FTD_EVENT_MASK OR'ed with TCLK event value -> read
on TCLK event (event constants are in 'tclk_events')
(can use the macro BUILD_EVENT_FTD(event) or
BUILD_EVENT_PLUS_DELAY_FTD(event,delay) in 'macro'))
errors array of returned ACNET status values (one for each
device in the list)
This function returns status values as follows:
OK success
DIO_NOLIST requested list does not exist
DIO_UNAVAIL not valid in this context (MIO in use)
negative value ACNET format error indicating overall failure
positive value number of first device in error
This function requires the following include files:
diolib_h, acnet_errors_h, tclk_events_h, macro_h
Related functions:
dio_bld_get(_c), dio_bld_get_raw(_c), dio_change_ftd,
dio_get_lst_raw(_c), dio_get_directed_list_raw_c, dio_get_lst,
dio_get_directed_list, dio_extract_read_list_status_c,
error_in_list(_c)
C/C++ usage:
short errors[NUM_DEVICES];
short ftd = FTD_1HZ;
int status;
int list_id;
status = dio_change_ftd_lst_c(list_id,ftd,errors);