IviSpecAn_CopyTrace
IviSpecAnMultitrace Capability Group
C Function Prototype
ViStatus IviSpecAn_CopyTrace (ViSession vi, ViConstString destinationTrace, ViConstString sourceTrace);
Purpose
This function copies one trace array to another trace array. Any data in the destination trace is over written.
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 |
| destinationTrace | ViConstString | Pass the trace name into which the array is stored.
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. |
| sourceTrace | ViConstString | Pass the trace name of the source trace array.
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. |