GtWaveArbSetWaveformLength

Supported By

GX1110, GX1120

Applies To

Arbitrary Waveform Generator mode only.

Purpose

Sets the waveform start address and length.

Syntax

GtWaveArbSetWaveformLength (nHandle, nChannel, dwStartAddress, dwLength, 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.
dwStartAddress
DWORD
GX1120: Waveform start address, any even value between 0 and 2097148 that can be divided by 4.
GX1120: Waveform start address, any even value between 0 and 33554430 that can be divided by 2.
dwLength
DWORD
GX1120: Waveform length can be any value between 4 and 2097152 that can be divided by 4. E.g. to run a waveform of 4096 steps starting from step 0, start address will be 0 and length be 4096.
GX1120: Waveform length can be any value between 2 and 33554432 that can be divided by 2.
pnStatus
PSHORT
Returned status: 0 on success, negative number on failure.

Example

The following example runs a waveform of 4096 steps starting from step 4:

 

GtWaveArbSetWaveformLength (nHandle, GTWAVE_CHANNEL_A, 4, 4096, &nStatus);

 

See Also

GtWaveArbGetWaveformLength, GtWaveArbSetMarker, GtWaveArbSetSampleRate, GtWaveArbSetSync, GtWaveArbFillPredefinedWaveform, GtWaveArbReadWaveformData, GtWaveArbWriteWaveformData, GtWaveArbFileLoad,  GtWaveArbFileSave