niHSDIO_WriteNamedWaveformFromFileHWS

Specific Function

C Function Prototype

ViStatus niHSDIO_WriteNamedWaveformFromFileHWS  (ViSession vi, ViConstString waveformName, ViConstString filePath, ViBoolean useRateFromWaveform, ViInt32* waveformSize);

Purpose

Reads and transfers data from a digital .hws file to onboard memory.

If you specify a waveformName not already allocated on the device, the appropriate amount of onboard memory is allocated (if available), and the data is stored in that new location.

Data is always written to memory starting at the current write position of the waveform. A new waveform's write position is the start of the allocated memory. Calling this function moves the next write position to the end of the data just written. Thus, subsequent calls to this function append data to the end of previously written data. You can manually change the write position by calling niHSDIO_SetNamedWaveformNextWritePosition. If you try to write past the end of the allocated space, NI-HSDIO returns an error.

Waveforms are stored contiguously in onboard memory. You cannot resize an existing named waveform. Instead, delete the existing waveform using niHSDIO_DeleteNamedWaveform and then re-create it with the new size using the same name.

This function calls niHSDIO_CommitDynamic— all pending attributes are committed to hardware.

Parameters

Return Value