VTI Instruments EX1000A, User Manual

Page: 251 / 320

www.vtiinstruments.com
EX10xxA Function Calls 251
vtex10xxA_set_scanlist
F
UNCTION
P
ROTOTYPE
ViStatus vtex10xxA_set_scanlist(ViSession vi , ViInt32 channels[] , ViInt32 numChannels );
F
UNCTION
P
ARAMETERS
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 array to receive the requested scan list. Valid input values: 0 through 47.
numChannels = an integer output value indicating how many channels are in the scan list. Valid input values: 1
through 48.
D
ATA
I
TEM
R
ESET
V
ALUE
channels = 0 numChannels = 1
D
ESCRIPTION
This function sets the scan list to be acquired. For the channels parameter, the elements of the array must be unique
(i.e. no repeated channels). The channels parameter should be set to an integer between 1 and 48.
vtex10xxA_get_scanlist is called, data is returned in ascending numerical order by channel number .
E
XAMPLE
// sequential order five-channel scan
ViInt32 channels[5] = { 0, 1, 2, 3, 4 };
vtex10xxA_set_scanlist(vi, channels, 5);
// reverse order five-channel scan
ViInt32 channels[5] = { 4, 3, 2, 1, 0 };
vtex10xxA_set_scanlist(vi, channels, 5);