OID_DOT11_CURRENT_CHANNEL (Compact 2013)

  • [アーティクル]

3/26/2014

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

When queried, this OID requests that the miniport driver return the value of the dot11CurrentChannel MIB object for the current PHY type.

The dot11CurrentChannel MIB object defines the current operating frequency channel that is used by the PHY for transmit and receive operations. For more information about frequency channels, refer to Clause 15.4.6.2 of the IEEE 802.11-1999 standard.

Note

Support for OID_DOT11_CURRENT_CHANNEL is mandatory if the network adapter supports PHY types of dot11_phy_type_dsss, dot11_phy_type_hrdsss, or dot11_phy_type_erp. 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 that specifies the channel number.

The dot11CurrentChannel MIB object is only valid for the following PHY types:

  • Direct-sequence spread spectrum (DSSS) PHY.
  • High-rate DSSS (HRDSSS) PHY.
  • Extended rate PHY (ERP).

If the current PHY type is not set to dot11_phy_type_dsss, dot11_phy_type_hrdsss, or dot11_phy_type_erp, the miniport driver must fail the query request by returning NDIS_STATUS_INVALID_DATA from its MiniportOidRequest function.

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

  • If the network adapter 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 performing a scan request, the miniport driver can 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.
    The miniport driver can fail the set request if the 802.11 station is unable to change channels when it performs the scan request.
  • 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 Extensible Station (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_AUTO_CONFIG_ENABLED
OID_DOT11_CURRENT_PHY_ID
Native 802.11 MIB OIDs
NDIS 5.x Legacy Reference