niHSDIO_WriteStaticU32

NI Digital Waveform Generator/Analyzer

niHSDIO_WriteStaticU32

Specific Function

C Function Prototype

ViStatus niHSDIO_WriteStaticU32 (ViSession vi, ViUInt32 writeData, ViUInt32 channelMask);

Purpose

This function writes to channels configured for static generation. You can configure a channel for static generation using the niHSDIO_AssignStaticChannels function.

Parameters

Name Type Description
vi ViSession This handle identifies your instrument session. vi was obtained from niHSDIO_InitGenerationSession.
writeData ViUInt32 Bit-value of data to drive on channels configured for static generation. 1 corresponds to logic high, 0 corresponds to logic low.

The least significant bit of writeData corresponds to the lowest physical channel number (for example, writeData of 0xFF00 means set the lower eight channels to 0, while setting the upper eight channels to logic high.

Data values in writeData corresponding to channels not configured for static generation are ignored.

Static channels explicitly disabled with the niHSDIO_TristateChannels function remain disabled, but the channel data value changes internally. Re-enabling a channel with niHSDIO_TristateChannels causes the channel to drive any value that you have written to it, even while the channel was disabled.
channelMask ViUInt32 Bit-value of channels to leave unchanged. 1 means to change the channel to whatever is reflected by writeData. 0 means do not alter the channel, regardless of writeData.

The least significant bit of channelMask corresponds to the lowest physical channel number (for example, writeData of 0xFFFF and channelMask of 0x0080 means set only channel 7 to 1; all other channels remain unchanged).

Default Value: -1

Return Value