DOT11_PHY_ATTRIBUTES結構 (windot11.h)

發行項
03/01/2024

重要原生 802.11 無線 LAN 介面在 Windows 10 和更新版本中已被取代。請改用 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 結構。

迷你埠驅動程序必須將 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) 通訊協定數據單位， (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

高速率直接序列散佈頻譜的 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 結構的數位。