VTI Instruments EX1629, User Manual

Page: 148 / 346

VTI Instruments Corp.
148 EX1629 Command Set
vtex1629_get_dio_config_events
F
UNCTION
P
ROTOTYPE
ViStatus vtex1629_get_dio_config_events (ViSession vi , ViInt32 inputLine , ViInt32 inputTrigType , ViInt32
numActions , ViReal64 _VI_FAR outputLineArr[] , ViReal64 _VI_FAR outputActionTypeArr[] , ViPInt32
numActionsActual );
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.
inputLine = defines the DIO input line whose configuration is being queried. Valid input values: 0 through 7.
inputTrigType = defines the input trigger type. Valid input values: 0 (high-to-low transition) or 1 (low-to-high
transition).
numActions = defines the size of the outputLineArr[] and outputActionTypeArr[] arrays. Valid input values: 0
through 8.
outputLineArr[] = an integer array containing a list of digital output lines that are affected by the inputLine and
inputTrigType combination. Valid return values: 0 through 7.
outputActionTypeArr[] = an integer array containing a list of the output action that will occur based on the
inputLine and inputTrigType parameters. Valid return values: 0 through 3.
numActionsActual = the actual number of actions available. Valid return values: 1 through 8.
D
ATA
I
TEM
R
ESET
V
ALUE
Not applicable to this function.
D
ESCRIPTION
This function queries and returns the current setting for DIO event transitions.
The
numActions parameter defines the size of both the outputLineArr[] and outputActionTypeArr[] arrays.
Although any value 0 through 8 is acceptable, to avoid possible errors, it is recommended that this parameter be set
to 8.
The
outputActionTypeArr[] parameter is an array which contains a list of output actions that will occur based on
events that occur on the specified inputLine . Note that each element of this array corresponds to the equivalent
index in the outputLineArr[] parameter. For example, the action type at element i in this array corresponds to (i.e.
will occur on) the line designated in element i of the outputLineArr[] array.
E
XAMPLE
ViSession instrumentHandle;
ViStatus status = VI_SUCCESS;
ViChar errMessage[256];
ViChar tempString[256] = "";
ViInt32 inputLine = 1;
ViInt32 inputTrigType = 2;
ViInt32 numActions = MAX_DIO_CHANNELS;
ViInt32 outputLineArr[MAX_DIO_CHANNELS];
ViInt32 outputActionTypeArr[MAX_DIO_CHANNELS];
...
memset(outputLineArr, 0x00, sizeof(outputLineArr));
memset(outputActionTypeArr, 0x00, sizeof(outputActionTypeArr));
status = vtex1629_get_dio_config_events(instrumentHandle,
inputLine,
inputTrigType,
numActions,
outputLineArr,
outputActionTypeArr);