VTI Instruments EX1629 - Vtex1629_Set_Excitation_Enabled

www.vtiinstruments.com
EX1629 Command Set 257
vtex1629_set_excitation_enabled
FUNCTION PROTOTYPE
ViStatus vtex1629_set_excitation_enabled (ViSession vi, ViInt32 _VI_FAR channels[], ViInt32
numberOfChannels, ViBoolean enabled);
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 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.
DATA ITEM RESET VALUE
enabled = 0
DESCRIPTION
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).
EXAMPLE
ViSession instrumentHandle;
ViStatus status;
ViInt32 channels[] = {0};
ViInt32 numberOfChannels = 1;
…
status = vtex1629_set_excitation_enabled(instrumentHandle,
channels,
numberOfChannels,
VI_TRUE);