NI-SCOPE .NET Class Library Help

Table of Contents

ScopeChannelMeasurement.FetchComplexDouble Method (PrecisionTimeSpan, Int64, ComplexWaveformCollection(ComplexDouble))

  • Updated2023-09-06
  • 2 minute(s) read
ScopeChannelMeasurement.FetchComplexDouble Method (PrecisionTimeSpan, Int64, ComplexWaveformCollection(ComplexDouble))

ScopeChannelMeasurementFetchComplexDouble Method (PrecisionTimeSpan, Int64, ComplexWaveformCollectionComplexDouble)

Retrieves data that the digitizer has acquired from a previously initiated acquisition and returns a one-dimensional array of complex, scaled waveforms.

Namespace:  NationalInstruments.ModularInstruments.NIScope
Assembly:  NationalInstruments.ModularInstruments.NIScope.Fx45 (in NationalInstruments.ModularInstruments.NIScope.Fx45.dll) Version: 2023

Syntax

public ComplexWaveformCollection<ComplexDouble> FetchComplexDouble(
	PrecisionTimeSpan timeout,
	long numberOfSamples,
	ComplexWaveformCollection<ComplexDouble> waveforms
)
Public Function FetchComplexDouble ( 
	timeout As PrecisionTimeSpan,
	numberOfSamples As Long,
	waveforms As ComplexWaveformCollection(Of ComplexDouble)
) As ComplexWaveformCollection(Of ComplexDouble)

Parameters

timeout
Type: NationalInstrumentsPrecisionTimeSpan
The time to wait for data to be acquired. Using 0 for this parameter tells NI-SCOPE to fetch whatever is currently available. Using -1 for this parameter implies infinite timeout.
numberOfSamples
Type: SystemInt64
The maximum number of samples to fetch for each waveform. If the acquisition finishes with fewer points than requested, some instruments return partial data if the acquisition finished, was aborted, or a timeout of 0 was used. Use –1 for this parameter if you want to fetch all available samples. The method reads the actual record length and attempts to acquire all available samples. If it fails to complete within the timeout period, the method returns an error.
waveforms
Type: NationalInstrumentsComplexWaveformCollectionComplexDouble
An array of type ComplexWaveformCollectionTData.

Return Value

Type: ComplexWaveformCollectionComplexDouble
An array of type ComplexWaveformCollectionTData

Exceptions

ExceptionCondition
ObjectDisposedExceptionFetchComplexDouble(PrecisionTimeSpan, Int64, ComplexWaveformCollectionComplexDouble) was called after the associated NIScope or ScopeDriverUtility object was disposed.
IviCDriverException The channel specified is not enabled.

- or -

The session is not configured to fetch complex measurements.

- or -

The underlying NI-SCOPE driver returned an error.

See Also

Log in to get a better experience