GtWaveGetTriggerBurstCount

Supported By

GX110, GX1120

Applies To

Function Generator and Arbitrary Waveform Generator modes.

Purpose

Returns the trigger burst count.

Syntax

GtWaveGetTriggerBurstCount (nHandle, nChannel, pdwCount, 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.
pdwCount
PDWORD
GX1120:
Trigger burst count can range from 1 (GTWAVE_GX1120_MIN_BURST_COUNT) to 9999999 (GTWAVE_GX1120_MAX_BURST_COUNT).
GX1120:
Trigger burst count can range from 1 (GTWAVE_GX1120_MIN_BURST_COUNT) to 9999999 (GTWAVE_GX1120_MAX_BURST_COUNT).
pnStatus
PSHORT
Returned status: 0 on success, negative number on failure.

Comments

When the trigger mode (by calling GtWaveGetTriggerMode function) is set to burst mode, which is an extension of the triggered mode, the generator can be programmed to output a pre-determined number of waveforms. The sources to trigger a burst are the same as for the trigger mode.

Example

The following example returns the trigger burst count:

 

DWORD dwCount;

GtWaveGetTriggerBurstCount (nHandle, GTWAVE_CHANNEL_A, &dwCount, &nStatus);

 

See Also

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