Compartilhar via


OID_DOT11_ACTIVE_PHY_LIST

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_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 an 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), which 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 and 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

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