DOT11_PHY_FREQUENCY_ADOPTED_PARAMETERS structure (windot11.h)

Article
03/15/2022

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.

The DOT11_PHY_FREQUENCY_ADOPTED_PARAMETERS structure specifies the channel or frequency that the 802.11 station has adopted to communicate with a peer station on an infrastructure BSS.

Syntax

typedef struct _DOT11_PHY_FREQUENCY_ADOPTED_PARAMETERS {
  NDIS_OBJECT_HEADER Header;
  ULONG              ulPhyId;
  union {
    ULONG ulChannel;
    ULONG ulFrequency;
  };
} DOT11_PHY_FREQUENCY_ADOPTED_PARAMETERS, *PDOT11_PHY_FREQUENCY_ADOPTED_PARAMETERS;

Members

Header

The type, revision, and size of the DOT11_PHY_FREQUENCY_ADOPTED_PARAMETERS structure. This member is formatted as an NDIS_OBJECT_HEADER structure.

The miniport driver must set the members of Header to the following values:

Type

This member must be set to NDIS_OBJECT_TYPE_DEFAULT.

Revision

This member must be set to DOT11_PHY_FREQUENCY_ADOPTED_PARAMETERS_REVISION_1.

Size

This member must be set to sizeof(DOT11_PHY_FREQUENCY_ADOPTED_PARAMETERS).

For more information about these members, see NDIS_OBJECT_HEADER.

ulPhyId

The value of an entry in the list of active PHY types defined by the msDot11ActivePhyList MIB object that specifies the current channel or frequency that the NIC has adopted to communicate over the BSS network.

The miniport driver sets msDot11ActivePhyList object to the list of PHYs that have been activated for use over the current BSS network connection. For more information about the msDot11ActivePhyList MIB object, see OID_DOT11_ACTIVE_PHY_LIST.

This member should not be set to DOT11_PHY_ID_ANY.

ulChannel

The channel number of the DSSS, HRDSSS, and ERP PHY configurations that the NIC has adopted to communicate over the BSS network.

ulFrequency

The orthogonal frequency division multiplexing (OFDM) frequency that the NIC has adopted to communicate over the BSS network.

Remarks

The Native 802.11 miniport driver includes a DOT11_PHY_FREQUENCY_ADOPTED_PARAMETERS structure when the driver makes an NDIS_STATUS_DOT11_PHY_FREQUENCY_ADOPTED status indication.

Requirements

Requirement	Value
Minimum supported client	Available in Windows 7 and later versions of the Windows operating systems.
Header	windot11.h (include Ndis.h)