GX1120
Function Generator and Arbitrary Waveform Generator modes.
Returns the filter mode.
GtWaveGetFilterMode (nHandle, nChannel, pnMode, pnStatus)
Name |
Type |
Comments |
nHandle |
SHORT |
Handle to a GX1100 board. |
nChannel |
SHORT |
Specified Channel number. GX1120: 0 = GTWAVE_CHANNEL_A: Channel A. |
pnMode |
PSHORT |
Filter mode: 0. GTWAVE_FILTER_MODE_AUTO – the driver applies the best filter for the active waveform automatically. 1. GTWAVE_FILTER_MODE_BAND_PASS – output filter is set to the band pass mode. This filter is most suitable when the board is in function generator mode and the waveform is not a square wave. 2. GTWAVE_FILTER_MODE_LOW_PASS - output filter is set to the low band pass filter mode. This filter is most suitable when the board is in Arbitrary Waveform Generator mode or when the board is in Function Generator mode and the waveform is a square wave. |
pnStatus |
PSHORT |
Returned status: 0 on success, negative number on failure. |
The output filter setting is different for Sinusoidal waveform and a Square waveform versus the Arbitrary mode of operation. The user can determine the filter settings or let the driver to apply the best filter for the active waveform.
The following example returns the filter mode:
SHORT nMode;
GtWaveGetFilterMode (nHandle, GTWAVE_CHANNEL_A, &nMode, &nStatus);