IviFgen_ConfigureAMInternal
IviFgenModulateAM Capability Group
C Function Prototype
ViStatus IviFgen_ConfigureAMInternal (ViSession vi, ViReal64 depth, ViInt32 waveform, ViReal64 frequency);
Purpose
This function configures the attributes that control the function generator's internal amplitude modulation source. These attributes are the modulation depth, waveform, and frequency.
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. |
| depth | ViReal64 | Pass the percentage of full modulation you want to apply to the carrier signal. The driver sets the IVIFGEN_ATTR_AM_INTERNAL_DEPTH attribute to this value. At 0% depth, the output amplitude equals the carrier signal's amplitude. At 100% depth, the output amplitude equals twice the carrier signal's amplitude. Units: Percentage (%) |
| waveform | ViInt32 | Pass the waveform you want to use to modulate the output signal. The driver sets the IVIFGEN_ATTR_AM_INTERNAL_WAVEFORM attribute to this value. Defined Values |
| frequency | ViReal64 | Pass the frequency at which you want the instrument to generate the modulating waveform. The driver sets the IVIFGEN_ATTR_AM_INTERNAL_FREQUENCY attribute to this value. Units: Hertz (Hz) |