RfsaIQAcquisition.MemoryOptimizedReadIQSingleRecordComplex(PrecisionTimeSpan, ComplexDouble[]) Method
- Updated2025-07-17
- 1 minute(s) read
Rfsa
Initiates an acquisition and fetches the 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 ComplexDouble[] MemoryOptimizedReadIQSingleRecordComplex( PrecisionTimeSpan timeout, ref ComplexDouble[] data )
Public Function MemoryOptimizedReadIQSingleRecordComplex ( timeout As PrecisionTimeSpan, ByRef data As ComplexDouble() ) As 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 the method waits until all data is available. A value of 0 specifies the method immediately returns available data.
- data ComplexDouble
- Returns the acquired waveform. New memory won't be allocated if the array is not null and its length is same as the NumberOfSamples.
Return Value
ComplexDoubleReturns the acquired waveform.
Exceptions
| Exception | Condition |
|---|---|
| ObjectDisposedException | The MemoryOptimizedReadIQSingleRecordComplex(PrecisionTimeSpan, ComplexDouble, RfsaWaveformInfo) method was accessed after the associated NIRfsa object was disposed. |
Remarks
Memory optimization is not guaranteed.