DOT11_PHY_ATTRIBUTES結構（windot11.h）

發行項
02/07/2025

重要 Windows 10 和更新版本中已淘汰 Native 802.11 無線 LAN 介面。請改用 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。

這個成員不適用於可延伸存取點（ExtAP）作業模式，而且當 NIC 處於 ExtAP 模式時會忽略。

uMPDUMaxLength

PHY 可以傳輸或接收之媒體訪問控制（MAC）通訊協定數據單位（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

高速率直接序列傳播頻譜（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 結構包含成員（pExtPhyAttributes），指定DOT11_PHY_ATTRIBUTES結構的數位位址。當迷你埠驅動程式呼叫 NdisMSetMiniportAttributes時，驅動程式會將 MiniportAttributes 參數設定為驅動程式配置的記憶體區塊位址，其中包含NDIS_MINIPORT_ADAPTER_NATIVE_802_11_ATTRIBUTES結構以及DOT11_PHY_ATTRIBUTES結構的數位。