GtWaveArbSetSync

Supported By

GX1110, GX1120

Applies To

Arbitrary Waveform Generator mode only.

Purpose

Sets the waveform sync bit state to the specified waveform memory locations.

Syntax

GtWaveArbSetSync (nHandle, nChannel, dwStartAddress, dwLength, bState, pnStatus)

Parameters

Name
Type
Comments
nHandle
SHORT
Handle to a GX1120 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: sync start address, any even value between 0 and 2097151.
GX1120: sync start address, any even value between 0 and 33554431.
dwLength
DWORD
GX1120: sync length can be any value between 1 and 2097152.
If dwLength is -1 will automatically fill all the steps between the start address and the end of the memory.
GX1120: When waveform length is set to be less than 2048, the sync can only start on multiples of 2 points and have length of multiples of 2. Otherwise, sync can only start on multiples of 8 points and have length of multiples of 8 and be between 1 and 33554432.
bState
BOOL

GX1120: Sync to be set to On or Off to the specified waveform memory locations.

GX1120: not applicable.
pnStatus
PSHORT
Returned status: 0 on success, negative number on failure.

Comments

The function selects the sync output address and length (pulse width) of the signal available at the Sync Out connector.

Example

The following example sets the waveform sync to on for 20 memory locations stating at address 2048:

 

GtWaveArbSetSync (nHandle, GTWAVE_CHANNEL_A, 2048, 20, TRUE, &nStatus);

 

See Also

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