DOT11_PHY_ATTRIBUTES结构（windot11.h）

项目
02/07/2025

重要 Windows 10 及更高版本中弃用了 Native 802.11 无线 LAN 接口。请改用 WLAN 设备驱动程序接口（WDI）。有关 WDI 的详细信息，请参阅 WLAN 通用 Windows 驱动程序模型。

DOT11_PHY_ATTRIBUTES结构定义 PHY 在 802.11 工作站上的物理和作属性。

语法

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;

成员

Header

DOT11_PHY_ATTRIBUTES结构的类型、修订和大小。此成员的格式设置为 NDIS_OBJECT_HEADER 结构。

微型端口驱动程序必须将标头的成员设置为以下值：

类型

此成员必须设置为NDIS_OBJECT_TYPE_DEFAULT。

校订

此成员必须设置为DOT11_PHY_ATTRIBUTES_REVISION_1。

大小

此成员必须设置为 sizeof（DOT11_PHY_ATTRIBUTES）。

有关这些成员的详细信息，请参阅 NDIS_OBJECT_HEADER。

PhyType

由 DOT11_PHY_TYPE 枚举器值指定的 PHY 的类型。

bHardwarePhyState

一个布尔值，该值指定 PHY 的硬件电源状态。如果 TRUE，则启用硬件电源状态。如果 FALSE，则禁用硬件电源状态。

有关 PHY 的硬件电源状态的详细信息，请参阅 OID_DOT11_HARDWARE_PHY_STATE。

注意每当 PHY 的硬件电源状态发生更改时，微型端口驱动程序必须发出 NDIS_STATUS_DOT11_PHY_STATE_CHANGED 特定于媒体的状态指示。

bSoftwarePhyState

一个布尔值，指定 PHY 的软件电源状态。如果 TRUE，则启用软件电源状态。如果 FALSE，则禁用软件电源状态。

有关 PHY 的软件电源状态的详细信息，请参阅 OID_DOT11_NIC_POWER_STATE。

注意每当 PHY 的软件电源状态发生更改时，微型端口驱动程序必须发出 NDIS_STATUS_DOT11_PHY_STATE_CHANGED 特定于媒体的状态指示。

bCFPollable

一个布尔值，如果设置为 TRUE，则表示 802.11 工作站支持 CF-Poll 帧。有关 CF-Poll 帧的详细信息，请参阅 IEEE 802.11-2012 标准的第 9.4 条款。

此成员不适用于可扩展接入点（ExtAP）作模式，在 NIC 处于 ExtAP 模式时被忽略。

uMPDUMaxLength

媒体访问控制（MAC）协议数据单元（MPDU）帧的最大长度（以字节为单位），PHY 可以传输或接收。有关详细信息，请参阅 OID_DOT11_MPDU_MAX_LENGTH。

注意每当 PHY 的软件电源状态更改时，微型端口驱动程序必须发出NDIS_STATUS_DOT11_MPDU_MAX_LENGTH_CHANGED特定于媒体的状态指示。

TempType

PHY 的运行温度范围，通过 DOT11_TEMP_TYPE 枚举值定义。

DiversitySupport

PHY 的天线多样性类型，通过 DOT11_DIVERSITY_SUPPORT 枚举值定义。

PhySpecificAttributes

PhySpecificAttributes.HRDSSSAttributes

高速率直接序列分布谱（HRDSS） PHY 类型的 PHY 特定属性。仅当 PhyType 成员设置为dot11_phy_type_hrdsss时，微型端口驱动程序才使用此成员。

PhySpecificAttributes.OFDMAttributes

正交频率除法（OFDM） PHY 类型的 PHY 特定属性。仅当 PhyType 成员设置为dot11_phy_type_ofdm时，微型端口驱动程序才使用此成员。

PhySpecificAttributes.ERPAttributes

扩展速率 PHY （ERP）类型的 PHY 特定属性。仅当 PhyType 成员设置为dot11_phy_type_erp时，微型端口驱动程序才使用此成员。

言论

这 NDIS_MINIPORT_ADAPTER_NATIVE_802_11_ATTRIBUTES 结构包含指定DOT11_PHY_ATTRIBUTES结构数组的地址的成员（pExtPhyAttributes）。当微型端口驱动程序调用 NdisMSetMiniportAttributes时，驱动程序会将 MiniportAttributes 参数设置为驱动程序分配的内存块的地址，该内存块包含NDIS_MINIPORT_ADAPTER_NATIVE_802_11_ATTRIBUTES结构以及DOT11_PHY_ATTRIBUTES结构的数组。