MemoryOptimizedReadIQSingleRecordComplexWaveform(PrecisionTimeSpan, ref ComplexWaveform< 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 ComplexWaveform< ComplexDouble > MemoryOptimizedReadIQSingleRecordComplexWaveform(PrecisionTimeSpan timeout, ref ComplexWaveform< ComplexDouble > waveform)
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. |
| waveform | ref ComplexWaveform< ComplexDouble > | 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. |
Returns
Returns the acquired waveform.
Exceptions
| Type | Description |
|---|---|
| System.ObjectDisposedException | The MemoryOptimizedReadIQSingleRecordComplexWaveform method was accessed after the associated NIRfsa object was disposed. |