niHWS_WriteDigital2DU32

NI-HWS C Function Reference

niHWS_WriteDigital2DU32

Specific Function

C Function Prototype

tHWS_Status niHWS_WriteDigital2DU32 (tHWS_WfmRef wfmReference, long numRows, long numSamplesPerRow, const unsigned long* wfmData);

Purpose

Writes a two-dimensional array of digital 32-bit unsigned integer (U32) waveform data into the waveform beginning at the current read/write position.

A write moves the read/write position such that it points to the next sample. Repeated writes to the same waveform concatenate data to that waveform.

When you call this function, the number of rows in the array must be equal to the number of rows in niHWS_Attr_ValidSignals.

If you have an existing waveform that contains data, the number of rows in the new data must equal the number of rows in the existing data.

Parameters

Name Type Description
wfmReference tHWS_WfmRef A reference to the waveform. Waveforms are identified by reference for purposes of setting and getting waveform attributes and reading and writing data.
numRows long The number of rows in the wfmData to write to the file.
numSamplesPerRow long The number of samples per row to write to the file.
wfmData const unsigned long* The array containing the data for the waveform. This array must be large enough to contain at least the amount of data indicated by the value assigned to the numSamplesPerRow parameter times the number of rows of the 2D waveform. You can get the number of rows using the niHWS_GetWfmI32Attribute function to get the niHWS_Attr_NumRows attribute.

Return Value