VTI Instruments EX1629 - Vtex1629_Set_Scanlist

www.vtiinstruments.com
EX1629 Command Set 279
vtex1629_set_scanlist
FUNCTION PROTOTYPE
ViStatus vtex1629_set_scanlist (ViSession vi, ViInt32 _VI_FAR channels[], ViInt32 numberOfChannels)
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.
channels = an integer input array indicating which channels will be included in the scan list. Valid input values: 0 to
47.
numberOfChannels = the size of the channels list. Valid input values: 1 to 48.
DATA ITEM RESET VALUE
channels = 0 to 47
DESCRIPTION
This function defines a list of channels which will be sampled in the data acquisition process. The term scanlist is
used, although all channels are sampled synchronously, and in parallel (not “scanned” as in a multiplexed ADC
system). The scanlist must include at least one channel and may not include any duplicate channels.
NOTE Regardless of the order of the elements in the array, when data is retrieved using
vtex1629_read_fifo or vtex1629_read_fifoEx, the data will be organized in ascending order with
respect to the elements in the scan list.
EXAMPLE
ViSession instrumentHandle;
ViStatus status;
ViInt32 channels[] = {0,1,2,3};
…
status = vtex1629_set_scanlist(instrumentHandle, channels, 4);