GtWaveArbGetWaveformLength

Supported By

GX1110, GX1120

Applies To

Arbitrary Waveform Generator mode only.

Purpose

Returns the waveform start address and length.

Syntax

GtWaveArbGetWaveformLength (nHandle, nChannel, pdwStartAddress, pdwLength, 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.
pdwStartAddress
PDWORD
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.
pdwLength
PDWORD
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 returns the waveform start address and length:

 

DWORD dwStartAddress, dwLength;

GtWaveArbGetWaveformLength (nHandle, GTWAVE_CHANNEL_A, &dwStartAddress, &dwLength, &nStatus);

 

See Also

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