Configures the start position to use the write a waveform with the next call to the WriteWaveform methods.

Syntax

Namespace: NationalInstruments.ModularInstruments.NIRfsg

public void SetArbWaveformNextWritePosition(string name, RfsgArbWaveformRelativeWritePosition relativeTo, int offset)

Remarks


Defined values:

  • StartOfWaveform - The reference position is relative to the start of the waveform.  

  • CurrentPosition - The reference position is relative to the current position.  

This method allows you to write to arbitrary locations within the waveform.

These settings apply only to the next write to the waveform specified by the name  of AllocateWaveform or one of the WriteWaveform methods. Subsequent writes to that waveform begin where the last write ended, unless this method is called again.

If you use this method to write to the waveform that is currently generating, an undefined output may result.

Supported Devices: PXIe-5644/5645/5646, PXIe-5820/5830/5831/5832/5840

Parameters

NameTypeDescription
namestring

The identity of the waveform. This string is case-insensitive, alphanumeric, and does not use reserved words.

relativeToRfsgArbWaveformRelativeWritePosition

The reference position in the waveform. The position and offset together determine where to start loading data into the waveform.

Parameters

NameTypeDescription
offsetint

The offset for relativeTo  at which to start loading the data into the waveform.

Exceptions

TypeDescription
System.ObjectDisposedException

The SetArbWaveformNextWritePosition method was accessed after the associated NIRfsg object was disposed.