VTI Instruments EX1629, User Manual

Page: 257 / 346

www.vtiinstruments.com
EX1629 Command Set 257
vtex1629_set_excitation_enabled
F
UNCTION
P
ROTOTYPE
ViStatus vtex1629_set_excitation_enabled (ViSession vi , ViInt32 _VI_FAR channels[] , ViInt32
numberOfChannels , ViBoolean enabled );
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 input integer array containing a list of channel numbers for which the excitation voltage will be
enabled or disabled. Valid input values: 0 to 47.
numberOfChannels = the size of the channels list. Valid input values: 1 to 48.
enabled = a Boolean input value which controls the enabling or disabling of the excitation voltage for a given list of
channels. Valid input values: 0 or 1.
D
ATA
I
TEM
R
ESET
V
ALUE
enabled = 0
D
ESCRIPTION
This function enables or disables the excitation voltages for a list of channels. Setting the enabled parameter to
VI_TRUE (1) enables excitation voltages, while setting it to VI_FALSE (0) disables excitation voltages. An
excitation source that is not enabled will output 0 V, regardless of its programmed value (please see Note 1 of the
vtex1629_set_excitation function for information regarding excitation precision).
E
XAMPLE
ViSession instrumentHandle;
ViStatus status;
ViInt32 channels[] = {0};
ViInt32 numberOfChannels = 1;
…
status = vtex1629_set_excitation_enabled(instrumentHandle,
channels,
numberOfChannels,
VI_TRUE);