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

niWLANG_SetMCSIndex

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_SetMCSIndex (niWLANGenerationSession session, char channelString[], int32 MCSIndex);

Purpose

Specifies the value of the modulation and coding scheme (MCS) index. The MCS index is a compact representation that determines the modulation scheme, coding rate, and number of spatial streams as specified in section 20.3.5 of IEEE Standard 802.11n-2009, section 22.5 of IEEE Standard 802.11ac-2013, section 24.5 of IEEE Standard P802.11ah/D1.3, section 23.5 of IEEE Standard 802.11af-2013, and section 28.5 of IEEE P802.11ax/D1.2.

To understand which active channel strings are required to configure this function, refer to the NIWLANG_MCS_INDEX attribute.

Parameters

Input
Name Type Description
session niWLANGenerationSession Specifies the niWLAN generation session.
channelString char[] Set this parameter to "" (empty string) or NULL.
MCSIndex int32 Specifies the value of the MCS index. The default value is 0. If you set the NIWLANG_STANDARD attribute to NIWLANG_VAL_STANDARD_80211AC_MIMO_OFDM and NIWLANG_VAL_STANDARD_80211AX_MIMO_OFDM, the valid values are 0 to 11, inclusive. If you set the NIWLANG_STANDARD attribute to NIWLANG_VAL_STANDARD_80211N_MIMO_OFDM, the valid values are 0 to 32, inclusive. If you set the NIWLANG_STANDARD attribute to NIWLANG_VAL_STANDARD_80211AH_MIMO_OFDM, the valid values are 0 to 10, inclusive. If you set the NIWLANG_STANDARD attribute to NIWLANG_VAL_STANDARD_80211AF_MIMO_OFDM, the valid values are 0 to 9, inclusive.

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