VTI Instruments EX1629 - Vtex1629_Get_Euconv_Excitation

VTI Instruments Corp.
154 EX1629 Command Set
vtex1629_get_euconv_excitation
FUNCTION PROTOTYPE
ViStatus vtex1629_get_euconv_excitation (ViSession vi, ViInt32 channel, ViPReal64 euConversionVoltage);
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.
channel =an integer input value that specifies the channel for which the EU conversion excitation voltage will be
returned. Valid input values: 0 to 47.
euConversionVoltage = a real return value, in volts, that indicates the EU conversion excitation voltage for the
given channel. Valid return values: 0.00000 to +16.00000.
DATA ITEM RESET VALUE
Not applicable to this function.
DESCRIPTION
This function queries and returns the current value used in EU conversions for the excitation voltage for a given
channel.
NOTE This value may be different than what is currently programmed on the excitation sources,
depending on the system configuration (although in almost all cases it should be the same). This
value is the number that is used int the formulas that convert voltage measurements to strain
measurements.
Please refer to vtex1629_get_excitation, vtex1629_get_excitation_enabled, and
vtex1629_measure_excitation_voltage for more information.
EXAMPLE
ViSession instrumentHandle;
ViStatus status;
ViReal64 euexcite;
…
status = vtex1629_get_euconv_excitation(instrumentHandle, 47, &euexcite);