IviSpecAn_QueryTraceSize

CVI/LabWindows IVI Class Driver

IviSpecAn_QueryTraceSize

IviSpecAnBase Capability Group

C Function Prototype

ViStatus IviSpecAn_QueryTraceSize (ViSession vi, ViConstString traceName, ViInt32* traceSize);

Purpose

This function queries the read-only IVISPECAN_ATTR_TRACE_SIZE attribute.

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

traceName ViConstString Pass the name of the trace which you request the trace size.

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.

traceSize ViInt32 Returns the number of points in the trace array. This value corresponds to the IVISPECAN_ATTR_TRACE_SIZE attribute.

Return Values