RfsaIQAcquisition.MemoryOptimizedReadIQSingleRecordComplexWaveform(PrecisionTimeSpan, ComplexWaveform<ComplexDouble>, RfsaWaveformInfo) Method
- Updated2025-07-17
- 2 minute(s) read
Rfsa
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
ComplexWaveformComplexDoubleReturns the acquired waveform.
Exceptions
Exception | Condition |
---|---|
ObjectDisposedException | The MemoryOptimizedReadIQSingleRecordComplexWaveform(PrecisionTimeSpan, ComplexWaveformComplexDouble, RfsaWaveformInfo) method was accessed after the associated NIRfsa object was disposed. |
Remarks
Memory optimization is not guaranteed.