Company Events Academic Community Support Solutions Products & Services Contact NI MyNI

niWLANG_SetNumberOfFrames

NI WLAN Generation Toolkit 17.0 Help

Edition Date: May 2017

Part Number: 373725G-01

»View Product Info
Download Help (Windows Only)

int32 __stdcall niWLANG_SetNumberOfFrames (niWLANGenerationSession session, char channelString[], int32 numberOfFrames);

Purpose

Specifies the number of frames to generate. Each iteration of the niWLANG_CreateWaveformComplexF64 or niWLANG_CreateMIMOWaveformsComplexF64 function generates only one frame along with the idle interval that you specify using the NIWLANG_IDLE_INTERVAL attribute.

If you set the numberOfFrames parameter to a value greater than 1, call the niWLANG_CreateWaveformComplexF64 function or the niWLANG_CreateMIMOWaveformsComplexF64 function in a loop and concatenate the output values from different iterations. If you encounter memory usage issues, download a single frame to the NI RF vector signal generator memory on each iteration.

To generate the required number of frames, wire the NIWLANG_NUMBER_OF_FRAMES attribute to the loop iteration count. You also can use the done parameter of the niWLANG_CreateWaveformComplexF64 or niWLANG_CreateMIMOWaveformsComplexF64 function as a termination signal.

You can use the niRFSG_AllocateArbWaveform function to preallocate arb memory and then download the waveform frame-by-frame.

Parameters

Input
Name Type Description
session niWLANGenerationSession Specifies the niWLAN generation session.
channelString char[] Set this parameter to "" (empty string) or NULL.
numberOfFrames int32 Specifies the number of frames to generate.

The default value is 1. Valid values are 1 to 1,000.

Return Value

Name Type Description
status int32 Returns the status code of this operation. The status code either indicates success or describes an error or warning condition. Examine the status code from each call to the function to determine if an error occurred.

To obtain a text description of the status code, call the niWLANG_GetErrorString function.

The general meaning of the status code is as follows:

Value Meaning
0 Success
Positive Values Warnings
Negative Values Errors

 

Your Feedback! poor Poor  |  Excellent excellent   Yes No
 Document Quality? 
 Answered Your Question? 
Add Comments 1 2 3 4 5 submit