OID_DOT11_SUPPORTED_POWER_LEVELS

  • Article

Important  The Native 802.11 Wireless LAN interface is deprecated in Windows 10 and later. Please use the WLAN Device Driver Interface (WDI) instead. For more information about WDI, see WLAN Universal Windows driver model.

 

When queried, the OID_DOT11_SUPPORTED_POWER_LEVELS OID requests that the miniport driver return the following for the current PHY type on the 802.11 station:

  • The number of transmit power levels supported by the Physical Media Dependent (PMD) sublayer of the PHY.

  • The transmit power for all the supported levels, in milliwatts (mWs).

The data type for OID_DOT11_SUPPORTED_POWER_LEVELS is the DOT11_SUPPORTED_POWER_LEVELS structure.

    typedef struct _DOT11_SUPPORTED_POWER_LEVELS {
         ULONG uNumOfSupportedPowerLevels;
         ULONG uTxPowerLevelValues[8];
    } DOT11_SUPPORTED_POWER_LEVELS, *PDOT11_SUPPORTED_POWER_LEVELS;

This structure includes the following members:

uNumOfSupportedPowerLevels
Number of supported power levels. uNumOfSupportedPowerLevels must have a value from 1 through 8.

uTxPowerLevelValues
An array of the supported transmit power levels in units of milliwatts (mWs). Each power level must be a value from 0 through 1000.

The miniport driver must use the power level specified in uTxPowerLevelValues[0] as its default power level. The miniport driver must set the power level of the 802.11 station to this default through its MiniportInitializeEx function or when reset through a method request of OID_DOT11_RESET_REQUEST.

If the miniport driver is operating in Extensible Station (ExtSTA) mode, the current PHY type is determined through the ExtSTA msDot11CurrentPhyID management information base (MIB) object. This MIB object specifies the index of the current PHY type within the 802.11 station's list of supported PHY types. For more information about msDot11CurrentPhyID, see OID_DOT11_CURRENT_PHY_ID.

Requirements

Version

Available in Windows Vista and later versions of the Windows operating systems.

Header

 Windot11.h (include Ndis.h)

See also

Native 802.11 Wireless LAN OIDs