FetchIQMultiRecordComplex(long, long, long, PrecisionTimeSpan, out ComplexSingle)
- Updated2025-10-14
- 1 minute(s) read
Fetches I/Q data from multiple records in an acquisition. 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.
Syntax
Namespace: NationalInstruments.ModularInstruments.NIRfsa
public ComplexSingle[,] FetchIQMultiRecordComplex(long startingRecord, long numberOfRecords, long numberOfSamples, PrecisionTimeSpan timeout, out ComplexSingle[,] data)
Remarks
This method is not necessary if you use the FetchIQMultiRecordComplex method because the FetchIQMultiRecordComplex method performs the fetch as part of the method.
Parameters
| Name | Type | Description |
|---|---|---|
| startingRecord | long | Specifies the first record to retrieve. Record numbers are zero-based. The default value is 0. |
| numberOfRecords | long | Specifies the number of records to fetch. |
| numberOfSamples | long | Specifies the number of samples per record. |
| timeout | PrecisionTimeSpan | PXI-5661, PXIe-5663/5665/5667 - Specifies the time, in seconds, allotted for the function to complete before returning a timeout error. PXIe-5644/5645/5646, PXIe-5668, PXIe-5830/5831/5832/5840 - Specifies the time, in seconds, allotted to receive the reference trigger. Note For all supported devices, a value of –1 specifies the function waits until all data is available. A value of 0 specifies the function immediately returns available data. |
| data | out ComplexSingle | Returns the acquired waveform for each record fetched. The waveforms are written sequentially in the array. Allocate an array at least as large as numberOfSamples times numberOfRecords for this parameter |
Returns
Returns the acquired waveform for each record fetched.
Exceptions
| Type | Description |
|---|---|
| System.ObjectDisposedException | The FetchIQMultiRecordComplex property was accessed after the associated NIRfsa object was disposed. |