IviFgen_ConfigureAMInternal

CVI/LabWindows IVI Class Driver

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)

Return Values