NI-HSDIO C Function Reference

niHSDIO_ReadStaticU32

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

ViStatus = niHSDIO_ReadStaticU32 ( ViSession vi, ViUInt32* data);

Purpose

Immediately reads the digital value on channels configured for static acquisition. Configure a channel for static acquisition using the niHSDIO_AssignStaticChannels function. Channels not configured for static acquisition return a zero.

Values obtained from static read operations are affected by data interpretation.

Related topics:

Parameters

Input
Name Type Description
vi ViSession Identifies your instrument session. vi was obtained from the niHSDIO_InitAcquisitionSession or niHSDIO_InitGenerationSession function.
Output
Name Type Description
Read Data ViUInt32 Bit-value of data read from channels configured for static acquisition.

The least significant bit of readData corresponds to the lowest physical channel number (for example, readData of 0x00F0 means channels 4-7 are logic one, while the remaining channels are logic zero or are not configured for static acquisition).

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

Log in to get a better experience