GtWaveGetTriggerMode

Supported By

GX1110, GX1120

Applies To

Function Generator and Arbitrary Waveform Generator modes.

Purpose

Returns the trigger mode.

Syntax

GtWaveGetTriggerMode (nHandle, nChannel, pnMode, pnStatus)

Parameters

Name
Type
Comments
nHandle
SHORT
Handle to a GX11X0 board.
nChannel
SHORT
Specified Channel number.
GX1120:
0 = GTWAVE_CHANNEL_A: Channel A.
GX1120:
0 = GTWAVE_CHANNEL_A: Channel A.
1 = GTWAVE_CHANNEL_B: Channel B.
pnMode
PSHORT
Trigger mode are:
0.        GTWAVE_TRIGGER_MODE_CONTINUOUS
1.        GTWAVE_TRIGGER_MODE_TRIGGERED
2.        GTWAVE_TRIGGER_MODE_GATED
3.        GTWAVE_TRIGGER_MODE_BURST
pnStatus
PSHORT
Returned status: 0 on success, negative number on failure.

 

Comments

Function Generator:
GTWAVE_TRIGGER_MODE_CONTINUOUS
The waveform is generated continuously by repeatedly cycling through the waveform table with the programmed waveform parameters.
GTWAVE_TRIGGER_MODE_TRIGGERED
Output is quiescent until triggered by an internal or external trigger, then, one waveform cycle is generated with the programmed waveform parameters.
GTWAVE_TRIGGER_MODE_GATED
The waveform generates continuously by repeatedly cycling through the waveform table as long as the gate is active.
GTWAVE_TRIGGER_MODE_BURST
After a trigger is received, waveform generation will be executed for the number of cycles that were defined by the GtWaveGetTriggerBurstCount function.
Arbitrary Waveform Generator mode:
GTWAVE_TRIGGER_MODE_CONTINUOUS
The waveform is generated continuously by repeatedly cycling through the defined waveform length at programmed waveform parameters. The waveform generation starts from the specified first address and continues through to the specified waveform length. After the last step is completed, the waveform generation loops back to the specified first address and continues until it is stopped.
GTWAVE_TRIGGER_MODE_TRIGGERED
Output quiescent until triggered by an internal or external trigger, then one waveform cycle is generated to programmed waveform parameters.
GTWAVE_TRIGGER_MODE_GATED
The waveform generates continuously by repeatedly cycling through the waveform table as long as the gate is active.
GTWAVE_TRIGGER_MODE_BURST
After a trigger is received, waveform generation starts from the specified first address and continues through to the specified waveform length. The number of cycles that was defined in the GtWaveGetTriggerBurstCount function.

Example

The following example returns the trigger mode:

 

SHORT nMode;

GtWaveGetTriggerMode (nHandle, GTWAVE_CHANNEL_A, &nMode, &nStatus);

 

See Also

GtWaveSetMarkerToPxiTriggerBusLine, GtWaveSetPxiTriggerBusLine, GtWaveSetTriggerBurstCount, GtWaveSetTriggerEdge, GtWaveSetTriggerInternalFrequency, GtWaveSetTriggerMode, GtWaveSetTriggerSource, GtWaveSetTriggerToPxiTriggerBusLine, GtWaveGetErrorString