Creates waveforms according to the parameters you specify, and saves the waveforms to a file.

Syntax

int32 __stdcall niBTSG_CreateAndWriteWaveformsToFile(niBTSGSession session, ViChar filePath, int32 fileOperation)

Remarks

In addition to the waveform, this function also saves the NIBTSG_ATTR_HEADROOM and NIBTSG_ATTR_IQ_RATE attributes to the file.

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.

filePath[out]ViChar

Specifies the absolute path to the file to which the BT Generation saves the waveforms.

fileOperation[in]int32

Specifies the operation to perform on the file.

NIBTSG_FILE_OPERATION_MODE_OPEN(0)

Opens an existing file to write the niBT SG session attribute values.

NIBTSG_FILE_OPERATION_MODE_OPENORCREATE(1)

Opens an existing file or creates a new file if the file does not exist.

NIBTSG_FILE_OPERATION_MODE_CREATEORREPLACE(2)

Creates a new file or replaces a file if it exists.

NIBTSG_FILE_OPERATION_MODE_CREATE(3)

Creates a new file.

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