gf.sub

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

 "    "

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 usesthe 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 "
 "toGF_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"
 "     "

2 all "Start Phase" GF_ATTR_FUNC_START_PHASE ViReal64 gs 
 "This channel-based attribute specifies the horizontal offset of the "
 "standard waveform the function generator produces.  You specify this "
 "attribute in degrees of one waveform cycle.  For example, a 180 degree "
 "phase offset means output generation begins half way through the waveform. "
 " A start phase of 360 degrees offsets the output by an entire waveform "
 "cycle.  It is therefore identical to a start phase of 0 degrees.\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"