Creates a waveform according to the values that you specify. This function generates one frame at a time.

Syntax

int32 __stdcall niBTSG_CreateWaveformComplexF64(niBTSGSession session, int32 reset, float64 *t0, float64 *dt, NIComplexNumber waveform, int32 waveformSize, int32 *actualWaveformSize, int32 *generationDone)

Parameters

NameDirectionTypeDescription
session[out]niBTSGSession

Specifies the niBT SG session. Use this parameter to configure the behavior and operation of the appropriate RFmx BT Generation function that accepts the niBTSGSession as an input.

reset[in]int32

Specifies whether to reset the internal states in the created waveform.

t0[out]float64 *

Returns the starting time, in seconds.

dt[out]float64 *

Returns the time interval between baseband I/Q samples, in seconds.

waveform[out]NIComplexNumber

Returns the array of baseband complex I/Q samples.

waveformSize[in]int32

Specifies the waveform size, in samples.

actualWaveformSize[out]int32 *

Returns the actual size of the waveform.

generationDone[out]int32 *

Indicates whether the function has generated all the frames.

Returns

Returns the status code of this operation. The status code either indicates success or describes an error or warning. Examine the status code from each call to an niBT SG function to determine if an error has occurred. To obtain a text description of the status code and additional information about the error condition, call the niBTSG_GetErrorString function. The general meaning of the status code is as follows:

Value

Meaning

0

Success

Positive Values

Warnings

Negative Values

Errors