niscopeobsolete.h

此为某测试平台的上位机软件部分

/****************************************************************************
 *                                niScope                                   *
 *--------------------------------------------------------------------------*
 *      Copyright (c) National Instruments 2001.  All Rights Reserved.      *
 *--------------------------------------------------------------------------*
 *                                                                          *
 * Title:    niScopeObsolete.h                                              *
 * Purpose:  niScope                                                        *
 *           instrument driver declarations.                                *
 *              These macros, constants, and functions are defined to keep  *
 *              backward compatibility with previous versions of niScope.   *
 *              Programs should no longer use these macros, constants, and  *
 *              functions. Instead, programs should use definitions from    *
 *              the current niScope.h header file.                          *
 *                                                                          *
 ****************************************************************************/

#ifndef __NISCOPE_HEADER_OBSOLETE
#define __NISCOPE_HEADER_OBSOLETE

/* Pragma used in CVI to indicate that functions in this file have 
 * user protection associated with them */
#ifdef _CVI_
 #pragma EnableLibraryRuntimeChecking
#endif

#include "ivi.h"

/*********************************************************
 Obsolete functions and functions used for class driver
 compliance.  These functions are not recommended to be
 used since they do allow for the NI-Scope extensions to
 the IviScope class specification.
 *********************************************************/


ViStatus _VI_FUNC niScope_ClearError (ViSession vi);  /* Not recommended */

ViStatus _VI_FUNC niScope_GetChannelName (ViSession vi, /* Not recommended */
                                          ViInt32 index,
                                          ViInt32 bufferSize,
                                          ViChar name[]);

ViStatus _VI_FUNC niScope_GetNextInterchangeWarning (ViSession vi, /* Not recommended */
                                                     ViInt32 bufferSize,
                                                     ViChar warnString[]);

ViStatus _VI_FUNC niScope_ResetInterchangeCheck (ViSession vi);   /* Not recommended */

ViStatus _VI_FUNC niScope_ClearInterchangeWarnings (ViSession vi);   /* Not recommended */

ViStatus _VI_FUNC niScope_GetNextCoercionRecord (ViSession vi,
                                                 ViInt32 bufferSize,
                                                 ViChar record[]); /* Not recommended */

ViStatus _VI_FUNC niScope_InvalidateAllAttributes (ViSession vi); /* Not recommended */

ViStatus _VI_FUNC niScope_ResetWithDefaults (ViSession vi); /* Not recommended */

ViStatus _VI_FUNC niScope_ConfigureAcquisitionType (ViSession vi,  /* Not recommended */
                                                    ViInt32 acquisitionType);

/* Vertical */
ViStatus _VI_FUNC niScope_ConfigureChannel (ViSession vi,          /* Not recommended */
                                             ViConstString channel,
                                             ViReal64 range,
                                             ViReal64 offset,
                                             ViInt32 coupling,
                                             ViReal64 probeAttenuation,
                                             ViBoolean enabled);


/* Horizontal */
ViStatus _VI_FUNC niScope_ConfigureHorizontal (ViSession vi,        /* Not recommended */
                                               ViReal64 timePerRecord,
                                               ViInt32 minNumPts,
                                               ViReal64 refPosition);

ViStatus _VI_FUNC niScope_ConfigureAcquisitionRecord (ViSession vi, /* Not recommended */
                                                      ViReal64 timePerRecord,
                                                      ViInt32 minNumPts,
                                                      ViReal64 acquisitionStartTime);

ViStatus _VI_FUNC niScope_ConfigureHorizontalRate (ViSession vi,   /* Not recommended */
                                                   ViReal64 minSampleRate,
                                                   ViInt32 minNumPts,
                                                   ViReal64 refPosition);

ViStatus _VI_FUNC niScope_ConfigureMultiHorizontal (ViSession vi,  /* Not recommended */
                                                    ViReal64 timePerRecord,
                                                    ViInt32 minNumPts,
                                                    ViReal64 refPosition,
                                                    ViInt32 numRecords);

ViStatus _VI_FUNC niScope_ConfigureMultiHorizontalRate (ViSession vi, /* Not recommended */
                                                        ViReal64 minSampleRate,
                                                        ViInt32 minNumPts,
                                                        ViReal64 refPosition,
                                                        ViInt32 numRecords);

/* Triggering */
ViStatus _VI_FUNC niScope_ConfigureTriggerSource (ViSession vi,      /* Not recommended */
                                                  ViConstString triggerSource,
                                                  ViInt32 triggerType,
                                                  ViReal64 triggerDelay,
                                                  ViReal64 holdoff);

ViStatus _VI_FUNC niScope_ConfigureTrigger (ViSession vi,           /* Not recommended */
                                            ViInt32 triggerType,
                                            ViReal64 holdoff);

ViStatus _VI_FUNC niScope_ConfigureTriggerCoupling (ViSession vi,   /* Not recommended */
                                                    ViInt32 coupling);

ViStatus _VI_FUNC niScope_ConfigureEdgeTrigger (ViSession vi,       /* Not recommended */
                                                ViReal64 level,
                                                ViInt32 triggerCoupling,
                                                ViInt32 slope);

ViStatus _VI_FUNC niScope_ConfigureEdgeTriggerSource (ViSession vi, /* Not recommended */
                                                      ViConstString source,
                                                      ViReal64 level,
                                                      ViInt32 slope);

ViStatus _VI_FUNC niScope_ConfigureHysteresisTrigger (ViSession vi, /* Not recommended */
                                                      ViReal64 level,
                                                      ViReal64 hysteresis,
                                                      ViInt32 triggerCoupling,
                                                      ViInt32 slope);

ViStatus _VI_FUNC niScope_ConfigureWindowTrigger (ViSession vi,     /* Not recommended */
                                                  ViReal64 lowLevel,
                                                  ViReal64 highLevel,
                                                  ViInt32 triggerCoupling,
                                                  ViInt32 windowMode);

ViStatus _VI_FUNC niScope_ConfigureDigitalTrigger (ViSession vi,   /* Not recommended */
                                                   ViInt32 slope);

ViStatus _VI_FUNC niScope_SendSWTrigger (ViSession vi); /* Not recommended */


/* Fetch Functions */
// Structs to handle non-copying Fetch Cluster routines, not recommended
#pragma pack(push,1)  

typedef struct 
{
   ViInt32 actualSamples;
   ViReal64 absoluteInitialX;
   ViReal64 relativeInitialX;
   ViReal64 xIncrement;
   ViReal64 offset;
   ViReal64 gain;
   ViReal64 reserved1;
   ViReal64 reserved2;
} tWfmInfo;

typedef struct 
{
   ViInt32 dimSize;
   tWfmInfo arg1[1];
} tWfmInfoArray;
typedef tWfmInfoArray** tWfmInfoArrayHdl;

typedef struct 
{
   ViInt32 dimSize;
   ViReal64 arg1[1];
} ViReal64LVArray;
typedef ViReal64LVArray** ViReal64LVArrayHdl;

typedef struct 
{
   ViInt32 rows;
   ViInt32 cols;
   ViChar arg1[1];
} tLV2DArray;
typedef tLV2DArray** tLV2DArrayHdl;
   
typedef struct
{
   ViReal64 relativeX;
   ViReal64 xIncrement;
   ViReal64LVArrayHdl lvDoubleArray;
} WfmCluster;

typedef struct
{
   ViInt32 dimSize;
   WfmCluster arg1[1];
} WfmClusterArray;
typedef WfmClusterArray** WfmClusterArrayHdl;

#pragma pack(pop)  // put packing back

ViStatus _VI_FUNC niScope_LVGenericFetch (ViSession vi,     /* Not recommended */
                                          ViConstString channel,
                                          ViReal64 timeout,
                                          ViInt32 numSamples,
                                          ViInt32 dataType,