NI-HSDIO C Function Reference

niHSDIO_ConfigureDataInterpretation

  • Updated2023-02-21
  • 2 minute(s) read

ViStatus = niHSDIO_ConfigureDataInterpretation ( ViSession vi, ViConstString channelList, ViInt32 dataInterpretation);

Purpose

Selects between high/low data or valid/invalid data interpretation during a static or dynamic acquisition operation.

Select NIHSDIO_VAL_HIGH_OR_LOW to get logic high or logic low values. Select NIHSDIO_VAL_VALID_OR_INVALID to determine if the signal is within the specified voltage range (above NIHSDIO_ATTR_DATA_VOLTAGE_LOW_LEVEL but below NIHSDIO_ATTR_DATA_VOLTAGE_HIGH_LEVEL) or outside the range (below NIHSDIO_ATTR_DATA_VOLTAGE_LOW_LEVEL or above NIHSDIO_ATTR_DATA_VOLTAGE_HIGH_LEVEL).

Note Note  NI 654x/656x devices only support the high/low mode of data interpretation. NI-HSDIO returns an error if you select valid/invalid mode for an acquisition with these devices.

Related topics:

Parameters

Input
Name Type Description
vi ViSession Identifies your instrument session. vi was obtained from the niHSDIO_InitAcquisitionSession or niHSDIO_InitGenerationSession function.
Channel List ViConstString Identifies channels to apply settings. Use "" or VI_NULL to specify all channels.
Data Interpretation ViInt32 Selects the data interpretation mode.

Defined Values

NIHSDIO_VAL_HIGH_OR_LOW (3)—Data read represents logical values (logic high or low level)

NIHSDIO_VAL_VALID_OR_INVALID (4)—Data read represents whether channel data is within the specified voltage range.

Return Value

Name Type Description
Status ViStatus

Reports the status of this operation. To obtain a text description of the status code, call the niHSDIO_error_message function. To obtain additional information concerning the error condition, use the niHSDIO_GetError and niHSDIO_ClearError functions.

The general meaning of the status code is as follows:

Value Meaning
0 Success
Positive Values Warnings
Negative Values Errors