niHWS_WriteDigitalU8

NI-HWS C Function Reference

niHWS_WriteDigitalU8

C Function Prototype

tHWS_Status niHWS_WriteDigitalU8 (tHWS_WfmRef wfmReference, long numSamples, const unsigned char* wfmData);

Purpose

Writes digital 8-bit unsigned integer (U8) waveform data into the waveform 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.

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.
numSamples long The number of samples in wfmData to write to the file.
wfmData const unsigned char* 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 numSamples.

Return Value