OID_DOT11_RF_USAGE

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_RF_USAGE object identifier (OID) requests that the miniport driver return the radio frequency (RF) usage detected on the wireless media by the current PHY type on the 802.11 station.

The data type for this OID is a ULONG value that represents the percentage of RF usage.

When OID_DOT11_RF_USAGE is queried, the miniport driver reports how busy the wireless media is. The 802.11 station must start gathering RF usage data after the PHY is turned on. The 802.11 station must clear its RF usage data after each query of OID_DOT11_RF_USAGE.

For more information about how to determine the RF usage of the wireless media, including physical carrier-sense and virtual carrier-sense methods, refer to clause 9.3.2.1 (for DCF operations) and clause 9.4 (for PCF operations) of the IEEE 802.11-2012 standard.

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 the ExtSTA msDot11CurrentPhyID MIB object, 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