NIRfsa Namespace

Table of Contents

RfsaIQAcquisition.MemoryOptimizedReadIQSingleRecordComplexWaveform(PrecisionTimeSpan, ComplexWaveform<ComplexDouble>, RfsaWaveformInfo) Method

  • Updated2025-07-17
  • 2 minute(s) read
RfsaIQAcquisition.MemoryOptimizedReadIQSingleRecordComplexWaveform(PrecisionTimeSpan, ComplexWaveform<ComplexDouble>, RfsaWaveformInfo) Method

RfsaIQAcquisitionMemoryOptimizedReadIQSingleRecordComplexWaveform(PrecisionTimeSpan, ComplexWaveformComplexDouble, RfsaWaveformInfo) Method

Initiates an acquisition and fetches I/Q data record in a single acquisition to optimize memory. Do not use this method if you have configured the device to continuously acquire data samples or to acquire multiple records.

Namespace: NationalInstruments.ModularInstruments.NIRfsa
Assembly: NationalInstruments.ModularInstruments.NIRfsa.Fx45 (in NationalInstruments.ModularInstruments.NIRfsa.Fx45.dll) Version: 2025

Syntax

public ComplexWaveform<ComplexDouble> MemoryOptimizedReadIQSingleRecordComplexWaveform(
	PrecisionTimeSpan timeout,
	ref ComplexWaveform<ComplexDouble> waveform,
	out RfsaWaveformInfo waveformInfo
)
Public Function MemoryOptimizedReadIQSingleRecordComplexWaveform ( 
	timeout As PrecisionTimeSpan,
	ByRef waveform As ComplexWaveform(Of ComplexDouble),
	<OutAttribute> ByRef waveformInfo As RfsaWaveformInfo
) As ComplexWaveform(Of ComplexDouble)

Parameters

timeout  PrecisionTimeSpan
Specifies the time, in seconds, allotted for the method to complete before returning a timeout error. A value of MaxValue specifies that the method waits until all data is available. A value of 0 specifies that the method immediately returns available data.
waveform  ComplexWaveformComplexDouble
Contains the ComplexWaveform object to be populated. New memory won't be allocated if the ComplexWaveform object is not null and its sampleCount is same as the NumberOfSamples.
waveformInfo  RfsaWaveformInfo
Contains the absolute and relative timestamps for the operation, the time interval, and the actual number of samples read.

Return Value

ComplexWaveformComplexDouble
Returns the acquired waveform.

Exceptions

ExceptionCondition
ObjectDisposedException The MemoryOptimizedReadIQSingleRecordComplexWaveform(PrecisionTimeSpan, ComplexWaveformComplexDouble, RfsaWaveformInfo) method was accessed after the associated NIRfsa object was disposed.

Remarks

Memory optimization is not guaranteed.

See Also

Log in to get a better experience