DOT11_PHY_ATTRIBUTES (Compact 2013)

Article
07/31/2017

3/26/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.

DataRateMappingEntries
An array of the data rates supported by the PHY. Each entry is formatted as a DOT11_DATA_RATE_MAPPING_ENTRY structure.

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

DOT11_PHY_ATTRIBUTES (Compact 2013)

Syntax

Members

Remarks

Requirements

See Also

Reference

Other Resources

Additional resources

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)