MemoryOptimizedReadIQSingleRecordComplex(PrecisionTimeSpan, ref ComplexDouble[])
- Updated2025-10-14
- 1 minute(s) read
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.
Syntax
Namespace: NationalInstruments.ModularInstruments.NIRfsa
public ComplexDouble[] MemoryOptimizedReadIQSingleRecordComplex(PrecisionTimeSpan timeout, ref ComplexDouble[] data)
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 the method waits until all data is available. A value of 0 specifies 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. |
Returns
Returns the acquired waveform.
Exceptions
| Type | Description |
|---|---|
| System.ObjectDisposedException | The MemoryOptimizedReadIQSingleRecordComplex method was accessed after the associated NIRfsa object was disposed. |