VTI Instruments EX1629 - Vtex1629_Get_Dio_Config_Events

VTI Instruments Corp.
148 EX1629 Command Set
vtex1629_get_dio_config_events
FUNCTION PROTOTYPE
ViStatus vtex1629_get_dio_config_events (ViSession vi, ViInt32 inputLine, ViInt32 inputTrigType, ViInt32
numActions, ViReal64 _VI_FAR outputLineArr[], ViReal64 _VI_FAR outputActionTypeArr[], ViPInt32
numActionsActual);
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.
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.
DATA ITEM RESET VALUE
Not applicable to this function.
DESCRIPTION
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.
EXAMPLE
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);