FetchIQMultiRecordComplex(long, long, long, PrecisionTimeSpan, out RfsaWaveformInfo[], out ComplexInt16)
- Updated2025-10-14
- 1 minute(s) read
Fetches I/Q data including absolute and relative timestamps for the operation, the time interval, and the actual number of samples read from multiple records in an acquisition.
Syntax
Namespace: NationalInstruments.ModularInstruments.NIRfsa
public ComplexInt16[,] FetchIQMultiRecordComplex(long startingRecord, long numberOfRecords, long numberOfSamples, PrecisionTimeSpan timeout, out RfsaWaveformInfo[] waveformInfo, out ComplexInt16[,] data)
Remarks
A 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, ReadIQSingleRecordComplexWaveform, MemoryOptimizedReadIQSingleRecordComplex, or MemoryOptimizedReadIQSingleRecordComplexWaveform methods, as the fetch is performed as part of these methods.
Parameters
| Name | Type | Description |
|---|---|---|
| startingRecord | long | Specifies the first record to retrieve. Record numbers are zero-based. |
| numberOfRecords | long | Specifies the number of records to fetch. |
| numberOfSamples | long | Specifies the number of samples per record. |
| 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. |
| waveformInfo | out RfsaWaveformInfo[] | Contains the absolute and relative timestamps for the operation, the time interval, and the actual number of samples read. |
| data | out ComplexInt16 | Specifies the acquired waveform for each record fetched. |
Returns
Returns the acquired waveform for each record fetched.
Exceptions
| Type | Description |
|---|---|
| System.ObjectDisposedException | The FetchIQMultiRecordComplex<T> method was accessed after the associated NIRfsa object was disposed. |