niHSDIO_ConfigureDataInterpretation

NI Digital Waveform Generator/Analyzer

niHSDIO_ConfigureDataInterpretation

Specific Function

C Function Prototype

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  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.

Parameters

Name Type Description
vi ViSession This handle identifies your instrument session. vi was obtained from niHSDIO_InitAcquisitionSession.
channelList ViConstString Identifies channels to apply settings. Use "" or VI_NULL to specify all channels.
dataInterpretation 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.

Default Value: NIHSDIO_VAL_HIGH_OR_LOW

Return Value