Share via

DOT11_PHY_ATTRIBUTES (Compact 7)

  • Article

3/12/2014

This structure defines the physical and operating attributes of a PHY on the 802.11 station.

Syntax

typedef struct DOT11_PHY_ATTRIBUTES {
  NDIS_OBJECT_HEADER  Header;
  DOT11_PHY_TYPE  PhyType;
  BOOLEAN  bHardwarePhyState;
  BOOLEAN  bSoftwarePhyState;
  BOOLEAN  bCFPollable;
  ULONG  uMPDUMaxLength;
  DOT11_TEMP_TYPE  TempType;
  DOT11_DIVERSITY_SUPPORT  DiversitySupport;
  union {
    DOT11_HRDSSS_PHY_ATTRIBUTES  HRDSSSAttributes;
    DOT11_OFDM_PHY_ATTRIBUTES  OFDMAttributes;
    DOT11_ERP_PHY_ATTRIBUTES  ERPAttributes;
    ;
  };
  ULONG  uNumberSupportedPowerLevels;
  ULONG  TxPowerLevels[8];
  ULONG  uNumDataRateMappingEntries;
  DOT11_DATA_RATE_MAPPING_ENTRY  DataRateMappingEntries[DOT11_RATE_SET_MAX_LENGTH];
  DOT11_SUPPORTED_DATA_RATES_VALUE_V2  SupportedDataRatesValue;
} DOT11_PHY_ATTRIBUTES, *PDOT11_PHY_ATTRIBUTES;

Members

  • Header
    The type, revision, and size of the DOT11_PHY_ATTRIBUTES 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

    DOT11_PHY_ATTRIBUTES_REVISION_1

    Size

    This member must be set to sizeof(DOT11_PHY_ATTRIBUTES_PARAMETERS)
  • PhyType
    The type of the PHY as specified by a DOT11_PHY_TYPE enumerator value

  • bHardwarePhyState
    A Boolean value that specifies the hardware power state of the PHY. If TRUE, the hardware power state is enabled. If FALSE, the hardware power state is disabled.

    For more information about the PHY’s hardware power state, see OID_DOT11_HARDWARE_PHY_STATE.

    Note

    When the PHY’s hardware power state changes, the miniport driver must make a NDIS_STATUS_DOT11_PHY_STATE_CHANGED media-specific indication.

  • bSfotwarePhyState
    A Boolean value that specifies the software power state of the PHY. If TRUE, the software power state is enabled. If FALSE, the software power state is disabled.

    For more information about the PHY’s software power state, see OID_DOT11_NIC_POWER_STATE.

    Note

    When the PHY’s software power state changes, the miniport driver must make a NDIS_STATUS_DOT11_PHY_STATE_CHANGED media-specific indication.

  • bCFPollable
    A Boolean value that, if set to TRUE, indicates that the 802.11 station supports CF-Poll frames. For more information about CF-Poll frames, refer to Clause 9.3 of the IEEE 802.11-1999 standard.

  • uMPDUMaxLength
    The maximum length, in bytes, of a media access control (MAC) protocol data unit (MPDU) frame that the PHY can transmit or receive. For more information, see OID_DOT11_MPDU_MAX_LENGTH.

    Note

    When the PHY’s software power state changes, the miniport driver must make a NDIS_STATUS_DOT11_MPDU_MAX_LENGTH_CHANGED media-specific indication.

  • TempType
    The PHY's operating temperature range, as defined through a DOT11_TEMP_TYPE enumeration value
  • DiversitySupport
    The PHY’s type of antenna diversity, which is defined through a DOT11_DIVERSITY_SUPPORT enumeration value
  • HRDSSSAttributes
    The PHY-specific attributes of a high-rate direct-sequence spread spectrum (HRDSS) PHY type. The miniport driver must use this member only if the PhyType member is set to dot11_phy_type_hrdsss.
  • OFDMAttributes
    The PHY-specific attributes of an orthogonal frequency division multiplexing (OFDM) PHY type. The miniport driver must use this member only if the PhyType member is set to dot11_phy_type_ofdm.
  • ERPAttributes
    The PHY-specific attributes of an extended rate PHY (ERP) type. The miniport driver must use this member only if the PhyType member is set to dot11_phy_type_erp.
  • uNumberSupportedPowerLevels
    The number of power levels within the TxPowerLevels array. uNumOfSupportedPowerLevels must have a value from 1 through 8.

  • SupportedDataRatesValue
    An array of the following data rates supported by the PHY:

    • The transmit data rates supported by the Physical Layer Convergence Procedure (PLCP) and Physical Media Dependent (PMD) sublayer of the PHY.
    • The receive data rates supported by the PLCP and PMD of the PHY.

    Each entry in the array is formatted as a DOT11_SUPPORTED_DATA_RATES_VALUE_V2 structure.

Remarks

The NDIS_MINIPORT_ADAPTER_NATIVE_802_11_ATTRIBUTES structure contains a member (pExtPhyAttributes) that specifies the address of an array of DOT11_PHY_ATTRIBUTES structures. When the miniport driver calls NdisMSetMiniportAttributes, the driver sets the MiniportAttributes parameter to the address of driver-allocated block of memory which contains an NDIS_MINIPORT_ADAPTER_NATIVE_802_11_ATTRIBUTES structure together with the array of DOT11_PHY_ATTRIBUTES structure.

Requirements

Header

windot11.h

See Also

Reference

Native 802.11 Data Types
NDIS_OBJECT_HEADER
OID_DOT11_HARDWARE_PHY_STATE
NDIS_STATUS_DOT11_PHY_STATE_CHANGED
OID_DOT11_NIC_POWER_STATE
OID_DOT11_MPDU_MAX_LENGTH
NDIS_STATUS_DOT11_MPDU_MAX_LENGTH_CHANGED
DOT11_TEMP_TYPE
DOT11_DIVERSITY_SUPPORT
DOT11_DATA_RATE_MAPPING_ENTRY
DOT11_SUPPORTED_DATA_RATES_VALUE_V2
NDIS_MINIPORT_ADAPTER_NATIVE_802_11_ATTRIBUTES
NdisMSetMiniportAttributes
Native 802.11 Wireless LAN Reference

Other Resources

DOT11_PHY_TYPE