windot11.h) (DOT11_PHY_ATTRIBUTES 结构

项目
03/08/2024

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

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

语法

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 结构。

微型端口驱动程序必须将 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 条。

此成员不适用于 Extensible Access Point (ExtAP) 操作模式，并且当 NIC 处于 ExtAP 模式时将被忽略。

uMPDUMaxLength

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

高速率直接序列传播谱的特定于 PHY 的属性 (HRDSS) PHY 类型。仅当 PhyType 成员设置为 dot11_phy_type_hrdsss 时，微型端口驱动程序才必须使用此成员。

PhySpecificAttributes.OFDMAttributes

正交频分多路复用的 PHY 特定属性 (OFDM) PHY 类型。仅当 PhyType 成员设置为 dot11_phy_type_ofdm 时，微型端口驱动程序必须使用此成员。

PhySpecificAttributes.ERPAttributes

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

注解

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