MemoryOptimizedFetchIQMultiRecordComplexWaveforms(long, long, long, PrecisionTimeSpan, ref ComplexWaveformCollection< ComplexSingle >, out RfsaWaveformInfo[])
- Updated2025-10-14
- 1 minute(s) read
Fetches I/Q data from multiple records in an acquisition in a memory optimized manner.
Syntax
Namespace: NationalInstruments.ModularInstruments.NIRfsa
public ComplexWaveformCollection< ComplexSingle > MemoryOptimizedFetchIQMultiRecordComplexWaveforms(long startingRecord, long numberOfRecords, long numberOfSamples, PrecisionTimeSpan timeout, ref ComplexWaveformCollection< ComplexSingle > waveforms, out RfsaWaveformInfo[] waveformInfo)
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 the method waits until all data is available. A value of 0 specifies the method immediately returns available data. |
| waveforms | ref ComplexWaveformCollection< ComplexSingle > | Contains the ComplexWaveformCollection object to be populated. New memory won't be allocated if the ComplexWaveformCollection object is not null and its number of records and number of samples are same as the numberOfRecords and the numberOfSamples respectively. |
| 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 for each record fetched.
Exceptions
| Type | Description |
|---|---|
| System.ObjectDisposedException | The MemoryOptimizedFetchIQMultiRecordComplexWaveforms property was accessed after the associated NIRfsa object was disposed. |