gf.sub.bak

机械工业出版社 Lab Windows/CVI逐步深入与开发实例源代码

3 all "Cache"                               GF_ATTR_CACHE                ViBoolean gs Boolean_values 
 "Specifies whether to cache the value of attributes.  "
 "When caching is enabled, the instrument driver keeps track of "
 "the current instrument settings and avoids sending redundant commands to "
 "the instrument.  Thus, you can significantly increase execution speed.\n"
 "    The instrument driver can choose always to cache or never to cache "
 "particular attributes regardless of the setting of this attribute.\n"
 "    The default value is VI_TRUE.   Use the "
 "GF_InitWithOptions function to override this value.\n"
 "    "
 
3 all "Simulate"                    GF_ATTR_SIMULATE                     ViBoolean gs Boolean_values 
 "Specifies whether or not to simulate instrument driver I/O "
 "operations.  If simulation is enabled, instrument driver "
 "functions perform range checking and call Ivi_GetAttribute and "
 "Ivi_SetAttribute functions, but they do not perform instrument I/O.  "
 "For output parameters that represent instrument data, the instrument "
 "driver functions return calculated values.\n"
 "    The default value is VI_FALSE.   Use the "
 "GF_InitWithOptions function to override this value.\n"
 "    "
 
3 all "Record Value Coercions"      GF_ATTR_RECORD_COERCIONS             ViBoolean gs Boolean_values       
 "Specifies whether the IVI engine keeps a list of "
 "the value coercions it makes for ViInt32 and ViReal64 attributes.  "  
 "You call Ivi_GetNextCoercionInfo to extract and delete the oldest "
 "coercion record from the list.\n"  
 "    The default value is VI_FALSE.   Use the "
 "GF_InitWithOptions function to override this value.\n"
 "    "

2 all "Instrument Capabilities"
 "Attributes that provide information about this instrument driver "
 "and the physical resource it is using.\n"
 "    "

3 all "Number of Channels"                  GF_ATTR_NUM_CHANNELS                 ViInt32   g
 "Indicates the number of channels that the specific instrument "
 "driver supports.  \n"
 "    For each attribute for which the IVI_VAL_MULTI_CHANNEL flag attribute "
 "is set, the IVI engine maintains a separate cache value for each channel.\n"
 "    "

3 all "Specific Driver Prefix"              GF_ATTR_SPECIFIC_PREFIX          ViString  g  
 "The prefix for the specific instrument driver.  The name of each "
 "user-callable function in this driver starts with this prefix.\n"
 "    The prefix can be up to a maximum of eight characters.\n"
 "    "

2 all "Version Info" 
 "Attributes for obtaining information about the version of the "
 "instrument driver and the IVI engine.\n"
 "    "

3 all "Driver Major Version"                GF_ATTR_DRIVER_MAJOR_VERSION         ViInt32   g 
 "The major version number of this instrument driver.\n"
 "    "

3 all "Driver Minor Version"                GF_ATTR_DRIVER_MINOR_VERSION         ViInt32   g 
 "The minor version number of this instrument driver.\n"
 "    "

3 all "Driver Revision"                     GF_ATTR_DRIVER_REVISION          ViString  g 
 "A string that contains additional version information about this "
 "instrument driver.\n"
 "    "

3 all "Engine Major Version"                GF_ATTR_ENGINE_MAJOR_VERSION         ViInt32   g 
 "The major version number of the IVI engine.\n"
 "    "

3 all "Engine Minor Version"                GF_ATTR_ENGINE_MINOR_VERSION         ViInt32   g 
 "The minor version number of the IVI engine.\n"
 "    "

3 all "Engine Revision"                     GF_ATTR_ENGINE_REVISION          ViString  g 
 "A string that contains additional version information about the IVI "
 "engine.\n"
 "    "

2 all "Error Info" 
 "Attributes for error information.\n"
 "    "

3 all "Primary Error"                       GF_ATTR_PRIMARY_ERROR                ViInt32   gs 
 "A code that describes the first error that occurred since the last "
 "call to GF_GetErrorInfo on the session.  The value follows the "
 "VXIplug&play completion code conventions.  A negative value describes "
 "an error condition.  A positive value describes a warning condition "
 "and indicates that no error occurred.  A zero indicates that no error "
 "or warning occurred. The error and warning values can be status codes "
 "defined by IVI, VISA, class drivers, or specific drivers.\n"
 "    "

3 all "Secondary Error"                     GF_ATTR_SECONDARY_ERROR          ViInt32   gs 
 "An optional code that provides additional information concerning the "
 "primary error condition.  The error and warning values can be status codes "
 "defined by IVI, VISA, class drivers, or specific drivers.  Zero indicates "
 "no additional information.\n"
 "    "

3 all "Error Elaboration"                   GF_ATTR_ERROR_ELABORATION            ViString  gs 
 "An optional string that contains additional information concerning the "
 "primary error condition.\n"
 "    "

2 all "Advanced Session I/O" 
 "Attributes that the specific driver can use to perform instrument I/O.  "
 "These attributes control advanced capabilities that, typically, "
 "only driver developers use.\n"
 "    "

3 all "VISA Resource Manager Session"       GF_ATTR_VISA_RM_SESSION          ViSession g 
 "If a specific driver uses VISA instrument I/O, it passes the "
 "value of this attribute to the viOpen function during initialization.  "
 "The viOpen function returns an instrument I/O session, which "
 "the driver stores in the GF_ATTR_IO_SESSION attribute.\n"
 "    "

3 all "Instrument I/O Session"              GF_ATTR_IO_SESSION               ViSession g  
 "Specifies the I/O session that the specific driver uses "
 "to communicate with the instrument.\n"
 "    If a specific driver uses VISA instrument I/O, it passes "
 "the value of the GF_ATTR_VISA_RM_SESSION attribute to the "
 "viOpen function and sets the GF_ATTR_IO_SESSION attribute to the VISA "
 "session handle that viOpen returns.\n"
 "    "

3 all "Defer Update"                GF_ATTR_DEFER_UPDATE                 ViBoolean gs Boolean_values 
 "Specifies whether to defer the actual updating of the "
 "physical instrument when you call one of the "
 "GF_SetAttribute functions.  The IVI engine performs all "
 "the deferred updates for the session when you call Ivi_Update.\n" 
 "    Typically, it is not necessary to defer updates.  "
 "Deferring updates can be useful when the overhead of initiating "
 "instrument I/O is very high.  By deferring updates, you can "
 "buffer multiple instrument commands into one I/O action.\n"  
 "    Generally, only instrument driver developers use this attribute, "
 "and they do so on a temporary basis around a sequence of calls to "
 "Ivi_SetAttribute functions.\n"
 "    The default value is VI_FALSE.\n"
 "    "

3 all "Return Deferred Values"      GF_ATTR_RETURN_DEFERRED_VALUES   ViBoolean gs Boolean_values 
 "When you call one of the GF_GetAttribute functions on an "
 "attribute that has a deferred update pending, this attribute specifies "
 "whether to return the deferred value or the value that represents the "
 "actual state of the instrument.\n"
 "    Generally, only instrument driver developers use this attribute.  "
 "For particular attributes, the instrument driver can choose to ignore this "
 "attribute and always return the value that represents the actual state of the "
 "instrument.\n"
 "    The default value is VI_TRUE.\n"
 "    "

1 all "Basic Operation" "Attributes that control the basic features of the function generator."

2 all "Output Mode" GF_ATTR_OUTPUT_MODE ViInt32 gs attrOutputModeRangeTable
 "Determines how the function generator produces waveforms.  The value you "
 "specify determines which functions and attributes you use to configure the "
 "waveform the function generator produces.\n"
 "    When you set this attribute to GF_VAL_OUTPUT_FUNC, you use the following attributes "
 "and functions to configure standard waveforms:\n\n"
 "GF_ATTR_FUNC_WAVEFORM\n"
 "GF_ATTR_FUNC_AMPLITUDE\n"
 "GF_ATTR_FUNC_DC_OFFSET\n"
 "GF_ATTR_FUNC_FREQUENCY\n"
 "GF_ATTR_FUNC_START_PHASE\n"
 "GF_ATTR_FUNC_DUTY_CYCLE_HIGH\n\n"
 "GF_ConfigureStandardWaveform\n\n"
 "    When you set this attribute to GF_VAL_OUTPUT_ARB, you use the following attributes "
 "and functions to configure arbitrary waveforms:\n\n"
 "GF_ATTR_ARB_WAVEFORM_HANDLE\n"
 "GF_ATTR_ARB_GAIN\n"
 "GF_ATTR_ARB_OFFSET\n"
 "GF_ATTR_ARB_SAMPLE_RATE\n\n"
 "GF_CreateArbWaveform\n"
 "GF_ClearArbWaveform\n"
 "GF_ConfigureArbWaveform\n"
 "GF_ConfigureSampleRate\n\n"
 "    When you set this attribute to GF_VAL_OUTPUT_SEQ, you use the following attributes "
 "and functions to configure sequences:\n\n"
 "GF_ATTR_ARB_SEQUENCE_HANDLE\n"
 "GF_ATTR_ARB_GAIN\n"
 "GF_ATTR_ARB_OFFSET\n"
 "GF_ATTR_ARB_SAMPLE_RATE\n\n"
 "GF_CreateArbSequence\n"
 "GF_ClearArbSequence\n"
 "GF_ClearArbMemory\n"
 "GF_ConfigureArbSequence\n"
 "      "

2 all "Reference Clock Source" GF_ATTR_REF_CLOCK_SOURCE ViInt32 gs attrRefClockSourceRangeTable 
 "Specifies the reference clock source.  The function generator derives frequencies and sample rates "
 "that it uses to generate waveforms from the source you specify.\n"
 "For example, when you set this attribute to GF_VAL_EXTERNAL, the function generator uses"
 "the signal it receives at its external clock terminal as its reference clock."
 "      "

2 all "Output Enabled" GF_ATTR_OUTPUT_ENABLED ViBoolean gs Boolean_values 
 "This channel-based attribute specifies whether the signal the function generator produces appears at the output connector.\n"
 "      "

2 all "Output Impedance" GF_ATTR_OUTPUT_IMPEDANCE ViReal64 gs attrOutputImpedanceRangeTable 
 "This channel-based attribute specifies the function generator's output impedance at the output connector.\n"
 "      "

1 all "Standard Function Output" "Attributes for generating standard function waveform output.  "
  "You use this group of attributes when you set the GF_ATTR_OUTPUT_MODE attribute to"
  "GF_VAL_OUTPUT_FUNC.  You can use the GF_ConfigureStandardWaveform "
  "function to set all these attributes except GF_ATTR_FUNC_DUTY_CYCLE_HIGH."

2 all "Waveform" GF_ATTR_FUNC_WAVEFORM ViInt32 gs attrFuncWaveformRangeTable
 "This channel-based attribute specifies which standard waveform the function generator produces.\n    "
 "You use this attribute only when the GF_ATTR_OUTPUT_MODE attribute is set to "
 "GF_VAL_OUTPUT_FUNC.\n"
 "      "

2 all "Amplitude" GF_ATTR_FUNC_AMPLITUDE ViReal64 gs 
 "This channel-based attribute specifies the amplitude of the standard waveform the function generator produces.  "
 "This value is the amplitude at the output terminal.  The units are volts peak-to-peak (Vpp).  "
 "For example, to produce a waveform ranging from -5.0 to +5.0 volts, you set this value to 10.0 volts.\n    "
 "You use this attribute only when the GF_ATTR_OUTPUT_MODE attribute is set to GF_VAL_OUTPUT_FUNC.  "
 "This attribute does not affect function generator behavior when you set the GF_ATTR_FUNC_WAVEFORM "
 "attribute to GF_VAL_WFM_DC.\n"
 "      "

2 all "DC Offset" GF_ATTR_FUNC_DC_OFFSET ViReal64 gs 
 "This channel-based attribute specifies the DC offset of the standard waveform the function generator produces.  "
 "This value is the offset at the output terminal.  The units are volts (V).  "
 "The value is the offset from ground to the center of the waveform you specify with the "
 "GF_ATTR_FUNC_WAVEFORM attribute.  "
 "For example, a standard waveform ranging from +5.0 volts to 0.0 volts has a DC offset of 2.5 volts.\n    "
 "You use this attribute only when the GF_ATTR_OUTPUT_MODE attribute is set "
 "to GF_VAL_OUTPUT_FUNC.\n"
 "      "

2 all "Frequency" GF_ATTR_FUNC_FREQUENCY ViReal64 gs 
 "This channel-based attribute specifies the frequency of the standard waveform the function generator produces.  "
 "The units are hertz (Hz).  "
 "You use this attribute only when the GF_ATTR_OUTPUT_MODE attribute is set "
 "to GF_VAL_OUTPUT_FUNC.\n    "
 "This attribute does not affect function generator behavior when "
 "you set the GF_ATTR_FUNC_WAVEFORM attribute to GF_VAL_WFM_DC.\n"