OID_DOT11_CURRENT_FREQUENCY (Compact 2013)

  • Article

3/26/2014

When set, this OID requests that the miniport driver set the value of the IEEE 802.11a dot11CurrentFrequency management information base (MIB) object for the current PHY type on the 802.11 station.

When queried, OID_DOT11_CURRENT_FREQUENCY requests that the miniport driver return the value of the dot11CurrentFrequency MIB object.

This MIB object defines the current operating frequency channel used by the PHY.

Note

Support for OID_DOT11_CURRENT_FREQUENCY is mandatory if the network adapter supports the dot11_phy_type_ofdm PHY type. For more information about how the miniport driver specifies its list of supported PHY types, see OID_DOT11_SUPPORTED_PHY_TYPES.

The data type for this OID is a ULONG value from 0 through 200.

Note

If a service that is provided by the independent hardware vendor (IHV) is managing the wireless network profiles, the IHV can use whatever value range it supports.

The dot11CurrentFrequency MIB object is valid only for the orthogonal frequency division multiplexing (OFDM) PHY type. If the current PHY type is not set to dot11_phy_type_ofdm, the miniport driver must fail the query request by returning NDIS_STATUS_INVALID_DATA from its MiniportOidRequest function.

When OID_DOT11_CURRENT_FREQUENCY is set, the miniport driver fails the request if the following conditions are true:

  • If the current PHY type is in a powered-off state, the miniport driver must fail the request by returning NDIS_STATUS_POWER_STATE_INVALID from its MiniportOidRequest function. For more information about power states, see OID_DOT11_NIC_POWER_STATE.
  • If the 802.11 station is currently performing a scan request, the miniport driver must fail the set request by returning NDIS_STATUS_MEDIA_IN_USE from its MiniportOidRequest function. For more information about scan requests, see OID_DOT11_SCAN_REQUEST.

If the miniport driver is operating in the Extensible Station (ExtSTA) mode, it fails the set request of OID_DOT11_CURRENT_FREQUENCY if the following conditions are true:

  • If the desired BSS type is dot11_BSS_type_infrastructure, the miniport driver must fail the set request by returning NDIS_STATUS_INVALID_DATA from its MiniportOidRequest function. For more information about the desired BSS type, see OID_DOT11_DESIRED_BSS_TYPE.
  • If the miniport driver has enabled automatic PHY configuration, it can fail the set request if the 802.11 station manages the PHY-layer configuration. In this situation, the driver returns NDIS_STATUS_AUTO_CONFIG_ENABLED from its MiniportOidRequest function.
    For more information about automatic PHY configuration, see OID_DOT11_AUTO_CONFIG_ENABLED.

If the miniport driver is operating in ExtSTA mode, the current PHY type is determined through the ExtSTA msDot11CurrentPhyID 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

Header

windot11.h

See Also

Reference

NDIS 5.x Legacy Wireless LAN OIDs
OID_DOT11_SUPPORTED_PHY_TYPES
MiniportOidRequest
OID_DOT11_NIC_POWER_STATE
OID_DOT11_SCAN_REQUEST
OID_DOT11_DESIRED_BSS_TYPE
OID_DOT11_AUTO_CONFIG_ENABLED
OID_DOT11_CURRENT_PHY_ID
Native 802.11 MIB OIDs
NDIS 5.x Legacy Reference