VTI Instruments EX1629 - Vtex1629_Get_Tare

VTI Instruments Corp.
190 EX1629 Command Set
vtex1629_get_tare
FUNCTION PROTOTYPE
ViStatus vtex1629_get_tare (ViSession vi, ViInt32 channel, ViPReal64 tareValue);
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 tare value will be returned. Valid input
values: 0 to 47.
tareValue = a real return value that indicates the currently configured tare value for the given channel.
DATA ITEM RESET VALUE
Not applicable to this function.
DESCRIPTION
This function reads the currently configured tare value for a specific channel. The tare value is subtracted from the
output of the EU conversion for the channel. It should be specified in the proper units for the EU conversion (e.g.,
strain, volts, etc.) For strain measurements, it is also important to take into account whether a strain measurement is
being output in strain (ε) or microstrain (µε) and configure the tare value appropriately.
EXAMPLE
ViSession instrumentHandle;
ViStatus status;
ViReal64 tare_value;
…
…
status = vtex1629_get_tare(instrumentHandle, 16, &tare_value);