ScopeChannelMeasurement.FetchComplexDouble Method (PrecisionTimeSpan, Int64, ComplexWaveformCollection(ComplexDouble))
- Updated2023-09-06
- 2 minute(s) read
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: ComplexWaveformCollectionComplexDoubleAn array of type ComplexWaveformCollectionTData
Exceptions
Exception | Condition |
---|---|
ObjectDisposedException | FetchComplexDouble(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. |