IviFgen_ConfigureOutputMode
IviFgen Base Capability Group
C Function Prototype
ViStatus IviFgen_ConfigureOutputMode (ViSession vi, ViInt32 outputMode);
Purpose
This function configures the output mode of the function generator. The output mode determines the kind of waveform the function generator produces. For example, you can output a standard waveform, an arbitrary waveform, or a sequence of arbitrary waveforms.
Parameters
| Name | Type | Description |
|---|---|---|
| vi | ViSession | The instrument handle that you obtain from the IviFgen_init or IviFgen_InitWithOptions functions. The handle identifies a particular IVI session. |
| outputMode | ViInt32 | Pass the output mode you want the function generator to use. The driver sets the IVIFGEN_ATTR_OUTPUT_MODE attribute to this value. The value you specify determines which functions and attributes you use to configure the waveform the function generator produces.
Defined Values: IVIFGEN_VAL_OUTPUT_FUNC—Standard Function Output IVIFGEN_VAL_OUTPUT_ARB—Arbitrary Waveform Output IVIFGEN_VAL_OUTPUT_SEQ—Arbitrary Sequence output |
Parameter Discussion for outputMode
This section describes the use of outputMode with the IVIFGEN_VAL_OUTPUT_FUNC, IVIFGEN_VAL_OUTPUT_ARB, and IVIFGEN_VAL_OUTPUT_SEQ values.
outputMode with IVIFGEN_VAL_OUTPUT_FUNC
When you set outputMode to IVIFGEN_VAL_OUTPUT_FUNC, use the IviFgen_ConfigureStandardWaveform function to configure the waveform.
Instead of using IviFgen_ConfigureStandardWaveform, you can set the following attributes:
- IVIFGEN_ATTR_FUNC_WAVEFORM
- IVIFGEN_ATTR_FUNC_AMPLITUDE
- IVIFGEN_ATTR_FUNC_DC_OFFSET
- IVIFGEN_ATTR_FUNC_FREQUENCY
- IVIFGEN_ATTR_FUNC_START_PHASE
- IVIFGEN_ATTR_FUNC_DUTY_CYCLE_HIGH
outputMode with IVIFGEN_VAL_OUTPUT_ARB
When you set outputMode to IVIFGEN_VAL_OUTPUT_ARB, use the following functions to configure the waveform:
- IviFgen_QueryArbWfmCapabilities
- IviFgen_CreateArbWaveform
- IviFgen_ClearArbWaveform
- IviFgen_ConfigureSampleRate
- IviFgen_ConfigureArbWaveform
- IviFgen_ConfigureArbFrequency
Instead of using the IviFgen_ConfigureSampleRate and IviFgen_ConfigureArbWaveform functions, you can set the following attributes:
- IVIFGEN_ATTR_ARB_WAVEFORM_HANDLE
- IVIFGEN_ATTR_ARB_GAIN
- IVIFGEN_ATTR_ARB_OFFSET
- IVIFGEN_ATTR_ARB_SAMPLE_RATE
- IVIFGEN_ATTR_ARB_FREQUENCY
outputMode with IVIFGEN_VAL_OUTPUT_SEQ
When you set outputMode to IVIFGEN_VAL_OUTPUT_SEQ, use the following functions to configure the sequence:
- IviFgen_QueryArbWfmCapabilities
- IviFgen_CreateArbWaveform
- IviFgen_ClearArbWaveform
- IviFgen_QueryArbSeqCapabilities
- IviFgen_CreateArbWaveform
- IviFgen_ClearArbSequence
- IviFgen_ClearArbMemory
- IviFgen_ConfigureSampleRate
- IviFgen_ConfigureArbSequence
Instead of using the IviFgen_ConfigureSampleRate% and IviFgen_ConfigureArbSequence functions, you can set the following attributes: