SmtCreateHandle

int CVIFUNC SmtCreateHandle (SmtHandle *handle);

Purpose

Creates a handle parameter that you must pass to the following functions that accept the handle parameter:

• SmtContZoomFFT
• SmtContZoomFFTEx
• SmtAveragedFFTSpectrum
• SmtAveragedPowerSpectrum
• SmtAveragedFrequencyResponse
• SmtAveragedCrossSpectrum

The handle parameter allows these functions to retain state information.

Create a unique handle for each data channel in your program. You can use the same handle for the SmtContZoomFFT, SmtAveragedFFTSpectrum, and SmtAveragedPowerSpectrum functions for computations on data from that channel.

The SmtAveragedFrequencyResponse and SmtAveragedCrossSpectrum functions act on spectrum data from two channels. You can pass the handle from any one of these channels to the handle parameter of these functions.

Call SmtDestroyHandle once for each handle created using SmtCreateHandle. Calling SmtDestroyHandle frees internal resources and discards the handle when you finish using it.

Parameters

Return Value