RfsaIQAcquisition.MemoryOptimizedFetchIQSingleRecord<T>(Int64, Int64, PrecisionTimeSpan, T[], T[]) Method
- Updated2025-07-17
- 2 minute(s) read
Rfsa
Fetches I/Q data in separate arrays from a single record in an acquisition.
Namespace: NationalInstruments.ModularInstruments.NIRfsa
Assembly: NationalInstruments.ModularInstruments.NIRfsa.Fx45 (in NationalInstruments.ModularInstruments.NIRfsa.Fx45.dll) Version: 2025
Syntax
public void MemoryOptimizedFetchIQSingleRecord<T>( long recordNumber, long numberOfSamples, PrecisionTimeSpan timeout, ref T[] iData, ref T[] qData )
Public Sub MemoryOptimizedFetchIQSingleRecord(Of T) ( recordNumber As Long, numberOfSamples As Long, timeout As PrecisionTimeSpan, ByRef iData As T(), ByRef qData As T() )
Parameters
- recordNumber Int64
- Specifies the record to retrieve. Record numbers are zero-based.
- numberOfSamples Int64
- Specifies the number of samples to fetch.
- 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.
- iData T
- Returns the acquired I data. New memory won't be allocated if the array is not null and the length is equal to numberOfSamples.
- qData T
- Returns the acquired Q data. New memory won't be allocated if the array is not null and the length is equal to numberOfSamples.
Type Parameters
- T
- The type of the underlying data.
Supported Type: Double
Exceptions
| Exception | Condition |
|---|---|
| ObjectDisposedException | The MemoryOptimizedFetchIQSingleRecordT(Int64, Int64, PrecisionTimeSpan, T, T, RfsaWaveformInfo) method was accessed after the associated NIRfsa object was disposed. |
Remarks
The fetch transfers acquired waveform data from device memory to computer memory. The data was acquired to onboard memory previously by the hardware after the acquisition was initiated. This method is not necessary if you use the ReadIQSingleRecordComplex(PrecisionTimeSpan, RfsaWaveformInfo) or MemoryOptimizedReadIQSingleRecordComplex(PrecisionTimeSpan, ComplexDouble, RfsaWaveformInfo) methods, as the fetch is performed as part of these methods.