NIRfsa Namespace

Table of Contents

RfsaIQAcquisition.FetchIQMultiRecordComplexWaveforms(Int64, Int64, Int64, PrecisionTimeSpan, RfsaWaveformInfo[], ComplexWaveformCollection<ComplexInt16>) Method

  • Updated2025-07-17
  • 2 minute(s) read
RfsaIQAcquisition.FetchIQMultiRecordComplexWaveforms(Int64, Int64, Int64, PrecisionTimeSpan, RfsaWaveformInfo[], ComplexWaveformCollection<ComplexInt16>) Method

RfsaIQAcquisitionFetchIQMultiRecordComplexWaveforms(Int64, Int64, Int64, PrecisionTimeSpan, RfsaWaveformInfo, ComplexWaveformCollectionComplexInt16) Method

Fetches I/Q data from multiple records in an acquisition.

Namespace: NationalInstruments.ModularInstruments.NIRfsa
Assembly: NationalInstruments.ModularInstruments.NIRfsa.Fx45 (in NationalInstruments.ModularInstruments.NIRfsa.Fx45.dll) Version: 2025

Syntax

public ComplexWaveformCollection<ComplexInt16> FetchIQMultiRecordComplexWaveforms(
	long startingRecord,
	long numberOfRecords,
	long numberOfSamples,
	PrecisionTimeSpan timeout,
	out RfsaWaveformInfo[] waveformInfo,
	out ComplexWaveformCollection<ComplexInt16> waveforms
)
Public Function FetchIQMultiRecordComplexWaveforms ( 
	startingRecord As Long,
	numberOfRecords As Long,
	numberOfSamples As Long,
	timeout As PrecisionTimeSpan,
	<OutAttribute> ByRef waveformInfo As RfsaWaveformInfo(),
	<OutAttribute> ByRef waveforms As ComplexWaveformCollection(Of ComplexInt16)
) As ComplexWaveformCollection(Of ComplexInt16)

Parameters

startingRecord  Int64
Specifies the first record to retrieve. Record numbers are zero-based.
numberOfRecords  Int64
Specifies the number of records to fetch.
numberOfSamples  Int64
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 MaxValue specifies the method waits until all data is available. A value of 0 specifies the method immediately returns available data.
waveformInfo  RfsaWaveformInfo
Contains the absolute and relative timestamps for the operation, the time interval, and the actual number of samples read.
waveforms  ComplexWaveformCollectionComplexInt16
Specifies the acquired waveform for each record fetched.

Return Value

ComplexWaveformCollectionComplexInt16
The acquired waveform for each record fetched.

Exceptions

ExceptionCondition
ObjectDisposedException The FetchIQMultiRecordComplexWaveformsT(Int64, Int64, Int64, PrecisionTimeSpan) method was accessed after the associated NIRfsa object was disposed.

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(PrecisionTimeSpan, RfsaWaveformInfo), ReadIQSingleRecordComplexWaveform(PrecisionTimeSpan, RfsaWaveformInfo), MemoryOptimizedReadIQSingleRecordComplex(PrecisionTimeSpan, ComplexDouble, RfsaWaveformInfo), or MemoryOptimizedReadIQSingleRecordComplexWaveform(PrecisionTimeSpan, ComplexWaveformComplexDouble, RfsaWaveformInfo) methods, as the fetch is performed as part of these methods.

See Also

Log in to get a better experience