GtWaveArbSetSampleRate

Supported By

GX1110, GX1120

Applies To

Arbitrary Waveform Generator mode only.

Purpose

Sets data point sampling rate.

Syntax

GtWaveArbSetSampleRate (nHandle, nChannel, pdSampleRate, 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.
dSampleRate
DOUBLE
GX1120: Returns the data point sampling rate, sampling rate can be between 1S/sec to 100MS/Sec.
GX1120: Returns the data point sampling rate, sampling rate can be between 0.01S/Sec to 250MS/Sec.
pnStatus
PSHORT
Returned status: 0 on success, negative number on failure.

Comments

Frequency accuracy of the output waveform is determined by the clock reference. If higher accuracy and/or stability is required, an external frequency reference can be used to replace the internal 10MHz reference clock.

The waveform frequency is given by the following equation: Frequency = 1/(Sample Rate * Wavelength)

Example

The following example sets the data point sampling rate to 10MHz:

 

GtWaveArbSetSampleRate (nHandle, GTWAVE_CHANNEL_A, 10e6, &nStatus);

 

See Also

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