VTI Instruments EX1000A, User Manual

Page: 191 / 320

www.vtiinstruments.com
EX10xxA Function Calls 191
vtex10xxA_get_trigger_source
F
UNCTION
P
ROTOTYPE
ViStatus vtex10xxA_get_trigger_source (ViSession vi ,ViInt16 _VI_FAR vtb_masks[] ,ViInt16 _VI_FAR
dio_masks[] ,ViPBoolean timer_enable ,ViPBoolean immediate );
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.
vtb_masks = A return array of four 8-bit integer values representing the enabled state of trigger events from the 8
channels of the trigger bus. The order of the values is: Positive edge, negative edge, positive level, negative level.
Within the 8-bit field, the MSB corresponds to VTB channel 7 and the LSB corresponds to VTB channel 0. Valid
input values: 0 through 255.
dio_masks = A return array of four 8-bit integer values representing the enabled state of trigger events from the 8
channels of the digital I/O port. The order of the values is: Positive edge, negative edge, positive level, negative
level. Within the 8-bit field, the MSB corresponds to DIO channel 7 and the LSB corresponds to DIO channel 0.
Valid input values: 0 through 255.
timer_enable = A Boolean value indicating whether the timer is enabled as a trigger event. If a “0” is returned for
this parameter, timer triggering is disabled.
immediate = A Boolean value indicating whether immediate is enabled as a trigger event. If a “0” is returned for
this parameter, immediate triggering is disabled.
D
ATA
I
TEM
R
ESET
V
ALUE
Not applicable to this function.
D
ESCRIPTION
This function returns the enabled trigger source events. Regardless of the response, software triggers are always
enabled. For the
vtb_masks , dio_masks , and lan_masks parameters, the data items in these arrays are ordered as
follows: positive edge, negative edge, positive level, negative level. For the lan_masks parameter, however, the
positive and negative level are not supported with LAN events and these bits are ignored.
NOTE This function is included for backward compatibility with the EX1048. In order to use this function,
the EX10xxA compatibility driver must be used.
E
XAMPLE