Partager via

OID_DOT11_ACTIVE_PHY_LIST (Compact 2013)

  • Article

3/26/2014

When queried, the OID_DOT11_ACTIVE_PHY_LIST object identifier (OID) requests that the miniport driver return the value of the Extensible Station (ExtSTA) msDot11ActivePhyList management information base (MIB) object.

The msDot11ActivePhyList MIB object specifies the PHYs on the 802.11 station that it can use for transmitting and receiving packets over the current basic service set (BSS) network connection. The miniport driver specifies the active PHY list when it makes a NDIS_STATUS_DOT11_ASSOCIATION_COMPLETION indication. This list must not change during the lifetime of the BSS network connection.

Each entry in the msDot11ActivePhyList MIB object is a PHY identifier (IDs). This identifier can be one of the following:

  • An index into the table of supported PHYs as defined by the Native 802.11 Operational msDot11SupportedPhyTypes MIB object. For more information about PHY IDs and the msDot11SupportedPhyTypes MIB object, see OID_DOT11_SUPPORTED_PHY_TYPES.
  • A PHY ID with the value of DOT11_PHY_ID_ANY that is the wildcard PHY ID. If the msDot11ActivePhyList MIB object contains the wildcard PHY ID, the 802.11 station can use any supported PHY to operate in the BSS network.

The msDot11ActivePhyList MIB object does not define the PHY IDs that can be used by the 802.11 station for scan operations. The PHY IDs that the 802.11 station uses for scanning are specified when OID_DOT11_SCAN_REQUEST is set.

The data type for this OID is the DOT11_PHY_ID_LIST structure.

When this OID is queried, the miniport driver must do the following:

  • If the 802.11 station is not connected to a BSS network, fail the query request by returning NDIS_STATUS_INVALID_STATE from its MiniportOidRequest function.
  • Verify that the InformationBuffer member of its MiniportOidRequest function’s OidRequest parameter is large enough to return the desired PHY ID list. For more information about this procedure, see DOT11_PHY_ID_LIST.

Requirements

Header

windot11.h

See Also

Reference

Native 802.11 Extensible Station OIDs
NDIS_STATUS_DOT11_ASSOCIATION_COMPLETION
OID_DOT11_SUPPORTED_PHY_TYPES
OID_DOT11_SCAN_REQUEST
DOT11_PHY_ID_LIST
MiniportOidRequest
DOT11_PHY_ID_LIST
Native 802.11 Wireless LAN OIDs