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

niWLANG_SetChannelBandwidth

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_SetChannelBandwidth (niWLANGenerationSession session, char channelString[], float64 channelBandwidth);

Purpose

Specifies the channel width used for transmitting the signal. This value is expressed in Hz.

If you set the NIWLANG_STANDARD attribute to NIWLANG_VAL_STANDARD_80211AG_OFDM, the channel bandwidth must be equal to 20 MHz. If you set the NIWLANG_STANDARD attribute to NIWLANG_VAL_STANDARD_80211J_OFDM, the channel bandwidth must be equal to 10 MHz or 20 MHz. If you set the NIWLANG_STANDARD attribute to NIWLANG_VAL_STANDARD_80211P_OFDM, the channel bandwidth must be equal to 5 MHz, 10 MHz, or 20 MHz. If you set the NIWLANG_STANDARD attribute to NIWLANG_VAL_STANDARD_80211N_MIMO_OFDM, the channel bandwidth must be either 20 MHz or 40 MHz. If you set the NIWLANG_STANDARD attribute to NIWLANG_VAL_STANDARD_80211AC_MIMO_OFDM or NIWLANG_VAL_STANDARD_80211AX_MIMO_OFDM, the channel bandwidth must be equal to 20 MHz, 40 MHz, 80 MHz, or 160 MHz. If you set the NIWLANG_STANDARD attribute to NIWLANG_VAL_STANDARD_80211AH_MIMO_OFDM, the channel bandwidth must be equal to 1 MHz, 2 MHz, 4 MHz, 8 MHz, or 16 MHz. If you set the NIWLANG_STANDARD attribute to NIWLANG_VAL_STANDARD_80211AF_MIMO_OFDM, the channel bandwidth must be equal to 6 MHz, 7 MHz, or 8 MHz. For OFDM signals, channel bandwidth determines the number of pilot and data subcarriers used. The toolkit ignores the niWLANG_SetChannelBandwidth function for other values of the NIWLANG_STANDARD attribute.

Parameters

Input
Name Type Description
session niWLANGenerationSession Specifies the niWLAN generation session.
channelString char[] Set this parameter to "" (empty string) or NULL.
channelBandwidth float64 Specifies the channel width used for transmitting the signal. The default value is 20 MHz. Valid values are 1 MHz, 2 MHz, 4 MHz, 5 MHz, 6 MHz, 7 MHz, 8 MHz, 10 MHz, 16 MHz, 20 MHz, 40 MHz, 80 MHz, and 160 MHz. This value is expressed in Hz.

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