VTI Instruments EX1000A - Vtex10 Xxa_Get_Dio_Output

VTI Instruments Corp.
164 EX10xxA/RX1032/EX1044 Function Calls
vtex10xxA_get_dio_output
FUNCTION PROTOTYPE
ViStatus vtex10xxA_get_dio_output(ViSession vi, ViPInt32 dio_out);
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.
dio_out = an integer output value in decimal that represents the programmed output state of the 8-bit port. Within
the 8-bit field, the MSB corresponds to DIO channel 7 and the LSB corresponds to DIO channel 0. Valid return
values: 0 through 255.
DATA ITEM RESET VALUE
Not applicable to this function.
DESCRIPTION
This function returns the programmed output state of the digital I/O port. This simply returns the programmed
setting. Since the outputs must be enabled, it does not necessarily represent the true output state.
EXAMPLE
// query status of DIO bit 4
ViInt32 dio_out;
ViInt32 dio_outen;
vtex10xxA_get_dio_output(vi, &dio_out);
vtex10xxA_get_dio_output_enable(vi, &dio_outen);
if (dio_out & 0x10)
printf(“Bit 4 is set high”);
else printf(“Bit 4 is set low”);
if (dio_outen & 0x10)
printf(“Bit 4 is enabled”);
else printf(“Bit 4 is not enabled”);