IviFgen_ConfigureBurstCount
IviFgenBurst Capability Group
C Function Prototype
ViStatus IviFgen_ConfigureBurstCount (ViSession vi, ViConstString channelName, ViInt32 burstCount);
Purpose
This function configures the burst count attribute. When the function generator receives a trigger, while in the Burst operation mode, it generates the number of waveform cycles you specify in the burstCount control.
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. |
| channelName | ViConstString | Pass the virtual channel name that you assign to the instrument in MAX. Virtual channel names are aliases for instrument specific channel strings. The instrument specific channel strings can differ from one instrument to another. Virtual channel names allow you to use and swap instruments without having to change the channel names in your source code. You assign a virtual channel name to an instrument specific channel through MAX. This control accepts virtual channel names you have assigned to the specific instrument you are using. It also accepts the instrument specific channel names. |
| burstCount | ViInt32 | Pass the number of waveform cycles that you want the function generator to produce after it receives a trigger. The driver sets the IVIFGEN_ATTR_BURST_COUNT attribute to this value. For standard and arbitrary waveforms, a cycle is one period of the waveform. An arbitrary sequence consists of multiple arbitrary waveforms in a sequence. Each waveform can be repeated a discrete number of times before the next waveform is produced. For arbitrary sequences, a cycle is one complete progression through the generation of all iterations of all waveforms in the sequence. |