GtWaveArbSetMarker

Supported By

GX1110, GX1120

Applies To

Arbitrary Waveform Generator mode only.

Purpose

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

Syntax

GtWaveArbSetMarker (nHandle, nChannel, dwStartAddress, dwLength, bState, 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 2097151.
GX1120: Waveform start address, any even value between 0 and 33554431.
dwLength
DWORD
GX1120: Waveform 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 marker can only start on multiples of 2 points and have length of multiples of 2. Otherwise, marker can only start on multiples of 8 points and have length of multiples of 8 and be between 1 and 33554432.
bState
BOOL
Marker to be set to On or of Off for specified waveform memory locations.
pnStatus
PSHORT
Returned status: 0 on success, negative number on failure.

Comments

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

Example

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

 

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

 

See Also

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