MemoryOptimizedReadIQSingleRecordComplex(PrecisionTimeSpan, ref ComplexDouble[], out RfsaWaveformInfo)
- Updated2025-10-14
- 1 minute(s) read
Initiates an acquisition and fetches a single I/Q data record to optimize memory. Do not use this method if you have configured the device to continuously acquire data samples or to acquire multiple records.
Syntax
Namespace: NationalInstruments.ModularInstruments.NIRfsa
public ComplexDouble[] MemoryOptimizedReadIQSingleRecordComplex(PrecisionTimeSpan timeout, ref ComplexDouble[] data, out RfsaWaveformInfo waveformInfo)
Remarks
Memory optimization is not guaranteed.
Parameters
| Name | Type | Description |
|---|---|---|
| timeout | PrecisionTimeSpan | Specifies the time, in seconds, allotted for the method to complete before returning a timeout error. A value of NationalInstruments.PrecisionTimeSpan.MaxValue specifies that the method waits until all data is available. A value of 0 specifies that the method immediately returns available data. |
| data | ref 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. |
| waveformInfo | out RfsaWaveformInfo | Contains the absolute and relative timestamps for the operation, the time interval, and the actual number of samples read. |
Returns
Returns the acquired waveform.
Exceptions
| Type | Description |
|---|---|
| System.ObjectDisposedException | The MemoryOptimizedReadIQSingleRecordComplex method was accessed after the associated NIRfsa object was disposed. |