IviSpecAn_ExchangeTraces

CVI/LabWindows IVI Class Driver

IviSpecAn_ExchangeTraces

IviSpecAnMultitrace Capability Group

C Function Prototype

ViStatus IviSpecAn_ExchangeTraces (ViSession vi, ViConstString trace1, ViConstString trace2);

Purpose

This function exchanges the data arrays of two traces.

Parameters

Name Type Description
vi ViSession The ViSession handle that you obtain from the IviSpecAn_init or IviSpecAn_InitWithOptions function. The handle identifies a particular instrument session.

Default Value: None

trace1 ViConstString Pass the trace name of one of the two traces to be exchanged.

This control accepts either a virtual repeated capability name or an instrument-specific trace name.

Virtual repeated capability names are aliases for instrument-specific trace strings. The instrument-specific trace strings can differ from one instrument to another. Virtual repeated capability names allow you to use and swap instruments without having to change the trace names in your source code. You specify virtual repeated capability names in MAX.


Default Value: ""

Note:

You can specify the trace name as a string variable or as a literal enclosed in double quotes.

trace2 ViConstString Pass the trace name of the second of the two traces to be exchanged.

This control accepts either a virtual repeated capability name or an instrument-specific trace name.

Virtual repeated capability names are aliases for instrument-specific trace strings. The instrument-specific trace strings can differ from one instrument to another. Virtual repeated capability names allow you to use and swap instruments without having to change the trace names in your source code. You specify virtual repeated capability names in MAX.


Default Value: ""

Note:

You can specify the trace name as a string variable or as a literal enclosed in double quotes.

Return Values