GtWaveSetOperationMode

Supported By

GX110, GX1120

Applies To

Function Generator and Arbitrary Waveform Generator modes.

Purpose

Sets the board’s operation mode.

Syntax

GtWaveSetOperationMode (nHandle, nChannel, nMode, pnStatus)

Parameters

Name
Type
Comments
nHandle
SHORT
Handle to a GX11X0 board.
nChannel
SHORT
TSpecified Channel number.
GX1120:
0 = GTWAVE_CHANNEL_A: Channel A.
GX1120:
0 = GTWAVE_CHANNEL_A: Channel A.
1 = GTWAVE_CHANNEL_B: Channel B.
nMode
SHORT
Each channel can be programmed to operate as Function Generator or as an Arbitrary Waveform Generator, modes are as follows:
0.      GTWAVE_OPERATING_MODE_FUNC: Function Generator mode
1.      GTWAVE_OPERATING_MODE_ARB:  Arbitrary Waveform Generator mode
GTWAVE_OPERATING_MODE_ARB_HIGH_SPEED: High speed Arbitrary Waveform Generator mode. In this mode both channels A and B are combined into one channel (Channel A) to produce a high speed Arbitrary Waveform Generator that can run as high as 400 MS/s.
pnStatus
PSHORT
Returned status: 0 on success, negative number on failure.

Comments

Each Channel can be programmed at any point in time to operate as Function Generator or as an Arbitrary Waveform Generator by calling the GtWaveSetOperationMode function. After calling GtWaveSetOperationMode function the board will be set to its default settings for the specifed operation mode.

Example

The following example sets the board’s operation mode to GTWAVE_OPERATING_MODE_ARB:

 

GtWaveSetOperationMode (nHandle, GTWAVE_CHANNEL_A, GTWAVE_OPERATING_MODE_ARB, &nStatus);

 

See Also

GtWaveGetOperationMode, GtWaveReset, GtWaveGetErrorString