VTI Instruments EX1000A - Vtex10 Xxa_Read_Fifoex

www.vtiinstruments.com
EX10xxA Function Calls 207
vtex10xxA_read_fifoEx
FUNCTION PROTOTYPE
ViStatus _VI_FUNC vtex10xxA_read_fifoEx(ViSession vi, ViInt32 maxscans, ViReal64 ts_secs[],
ViReal64 ts_fsecs[], ViPInt32 numscans, ViInt32 maxdata, ViReal64 data[], ViPInt32 numdata,
ViInt32 maxcjcdata, ViReal64 cjcdata[], ViPInt32 numcjcdata, ViInt32 to_secs);
FUNCTION PARAMETERS
vi = contains a session handle to the instrument. This handle is obtained by the function and remains valid until the
session is closed.
maxscans = the maximum number of scans to return. Valid return values: 1 through (2
31
-1).
ts_secs[] = a return array of scan start times, specified in seconds since the epoch (Jan. 1, 1970).
ts_fsecs[] = a return array of scan start times, specified in seconds since the last full second represented in ts_secs[].
numscans = an integer output value indicating the actual number of scans retrieved. Valid
maxdata = the maximum length of the return data array. Valid return values: 1 through (2
31
-1).
data[] = a return array of sample data.
numdata = an integer output value indicating the actual number of samples retrieved. Valid return values: 1 through
(2
31
-1).
maxcjcdata = the maximum length of the return CJC data array. Valid return values: 1 through (2
31
-1).
cjcdata = a return array of CJC data.
numcjcdata = an integer output value indicating the actual number of CJC data retrieved. Valid return values:
1 through (2
31
-1).
to_secs = the timeout period (in seconds), indicating how long to poll the EX10xxA for data. Valid return values:
0 through (2
31
-1), where 0 represents an infinite timeout period.
DATA ITEM RESET VALUE
Not applicable to this function.
DESCRIPTION
This function retrieves acquisition data with timestamps and CJC data. Data returned by this function includes input
channel measurement data and the start time of each scan.
NOTE In order to provide the maximum reading buffer capacity for future acquisitions, data is deleted from
the FIFO memory upon retrieval.
EXAMPLE
ViInt32 channels[5] = {0, 1, 2, 3, 4};
ViReal64 ts_secs[20], ts_fsecs[20], data[100];