VTI Instruments EX1000A, User Manual

Page: 144 / 320

VTI Instruments Corp.
144 EX10xxA/RX1032/EX1044 Function Calls
vtex10xxA_get_accum_limit_status
F
UNCTION
P
ROTOTYPE
ViStatus vtex10xxA_get_accum_limit_status(ViSession vi , ViBoolean set0_lower[] , ViBoolean set0_upper[] ,
ViBoolean set1_lower[] , ViBoolean set1_upper[] );
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.
set0_lower[] = a return array of Boolean values representing the accumulated limit status of all 48 channels with
respect to each channel’s limit set 0 lower limit. Channel 0 through channel 47 are represented in array elements [0]
through [47], respectively. If a “1” is returned, the set 0 lower limit has been tripped. If a “0” is returned, the set 0
lower limit has not been tripped.
set0_upper[] = a return array of Boolean values representing the accumulated limit status of all 48 channels with
respect to each channel’s limit set 0 upper limit. Channel 0 through channel 47 are represented in array elements [0]
through [47], respectively. If a “1” is returned, the set 0 upper limit has been tripped. If a “0” is returned, the set 0
upper limit has not been tripped.
set1_lower[] = a return array of Boolean values representing the accumulated limit status of all 48 channels with
respect to each channel’s limit set 1 lower limit. Channel 0 through channel 47 are represented in array elements [0]
through [47], respectively. If a “1” is returned, the set 1 lower limit has been tripped. If a “0” is returned, the set 1
lower limit has not been tripped.
set1_upper[] = a return array of Boolean values representing the accumulated limit status of all 48 channels with
respect to each channel’s limit set 1 upper limit. Channel 0 through channel 47 are represented in array elements [0]
through [47], respectively. If a “1” is returned, the set 1 upper limit has been tripped. If a “0” is returned, the set 1
upper limit has not been tripped.
D
ATA
I
TEM
R
ESET
V
ALUE
Not applicable to this function.
D
ESCRIPTION
This function returns the accumulated limit status of all 48 channels. Limit status is returned for all channels,
regardless of their inclusion in the scan list. The returned values represent, on a per channel basis, any excursion of
the measurement data over their respective limits since the last trigger initialize. As implied, limit status is cleared as
part of the vtex10xxA_init_imm function.
The limit status for unscanned channels is always 0.
E
XAMPLE