DOT11_PHY_ATTRIBUTES Struktur (windot11.h)

Artikel
02/07/2025

Wichtige Die Native 802.11 Wireless LAN--Schnittstelle ist in Windows 10 und höher veraltet. Verwenden Sie stattdessen die WLAN Device Driver Interface (WDI). Weitere Informationen zu WDI finden Sie unter WLAN Universal Windows driver model.

Die DOT11_PHY_ATTRIBUTES-Struktur definiert die physischen und Betriebsattribute eines PHY auf der Station 802.11.

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;

Angehörige

Header

Der Typ, die Überarbeitung und die Größe der DOT11_PHY_ATTRIBUTES Struktur. Dieses Element ist als NDIS_OBJECT_HEADER Struktur formatiert.

Der Miniporttreiber muss die Member Header- auf die folgenden Werte festlegen:

Art

Dieses Element muss auf NDIS_OBJECT_TYPE_DEFAULT festgelegt werden.

Revision

Dieses Element muss auf DOT11_PHY_ATTRIBUTES_REVISION_1 festgelegt werden.

Größe

Dieses Element muss auf sizeof(DOT11_PHY_ATTRIBUTES) festgelegt werden.

Weitere Informationen zu diesen Mitgliedern finden Sie unter NDIS_OBJECT_HEADER.

PhyType

Der Typ des PHY, wie durch einen DOT11_PHY_TYPE Enumerationswert angegeben.

bHardwarePhyState

Ein boolescher Wert, der den Hardwareleistungsstatus des PHY angibt. Wenn TRUE, ist der Hardware-Energiezustand aktiviert. Wenn FALSE-, ist der Hardware-Energiezustand deaktiviert.

Weitere Informationen zum Hardwareleistungszustand des PHY finden Sie unter OID_DOT11_HARDWARE_PHY_STATE.

Hinweis Wenn sich der Hardware-Leistungszustand des PHY ändert, muss der Miniporttreiber einen NDIS_STATUS_DOT11_PHY_STATE_CHANGED medienspezifische Statusanzeige.

bSoftwarePhyState

Ein boolescher Wert, der den Softwareleistungsstatus des PHY angibt. Wenn TRUE-, ist der Software-Energiezustand aktiviert. Wenn FALSE-, ist der Software-Energiezustand deaktiviert.

Weitere Informationen zum Softwareleistungszustand des PHY finden Sie unter OID_DOT11_NIC_POWER_STATE.

Hinweis Wenn sich der Software-Energiezustand des PHY ändert, muss der Miniporttreiber einen NDIS_STATUS_DOT11_PHY_STATE_CHANGED medienspezifische Statusanzeige.

bCFPollable

Ein boolescher Wert, der bei Festlegung auf TRUEangibt, dass die Station 802.11 CF-Poll Frames unterstützt. Weitere Informationen zu CF-Poll Frames finden Sie in Abschnitt 9.4 des IEEE 802.11-2012-Standards.

Dieses Element gilt nicht für den Extensible Access Point (ExtAP)-Vorgangsmodus und wird ignoriert, wenn sich die NIC im ExtAP-Modus befindet.

uMPDUMaxLength

Die maximale Länge eines MAC-Protokolldateneinheitsframes (Media Access Control, MAC) in Bytes, den der PHY übertragen oder empfangen kann. Weitere Informationen finden Sie unter OID_DOT11_MPDU_MAX_LENGTH.

Hinweis Wenn sich der Software-Energiezustand des PHY ändert, muss der Miniporttreiber eine NDIS_STATUS_DOT11_MPDU_MAX_LENGTH_CHANGED medienspezifische Statusanzeige vornehmen.

TempType

Der Betriebstemperaturbereich des PHY, definiert durch einen DOT11_TEMP_TYPE Enumerationswert.

DiversitySupport

Der PHY-Typ der Antennenvielfalt, definiert durch einen DOT11_DIVERSITY_SUPPORT Enumerationswert.

PhySpecificAttributes

PhySpecificAttributes.HRDSSSAttributes

Die PHY-spezifischen Attribute eines PHY-Typs mit hoher Rate direct-sequence spread spectrum (HRDSS) PHY. Der Miniporttreiber muss dieses Element nur verwenden, wenn der PhyType- Member auf dot11_phy_type_hrdsss festgelegt ist.

PhySpecificAttributes.OFDMAttributes

Die PHY-spezifischen Attribute eines orthogonalen Frequenzteilungs-Multiplexing -PHY-Typs (OFDM). Der Miniporttreiber muss dieses Element nur verwenden, wenn der PhyType- Member auf dot11_phy_type_ofdm festgelegt ist.

PhySpecificAttributes.ERPAttributes

Die PHY-spezifischen Attribute eines ERP-Typs (Extended Rate PHY). Der Miniporttreiber muss dieses Element nur verwenden, wenn der PhyType Member auf dot11_phy_type_erp festgelegt ist.

Bemerkungen

Das NDIS_MINIPORT_ADAPTER_NATIVE_802_11_ATTRIBUTES Struktur enthält ein Element (pExtPhyAttributes), das die Adresse eines Arrays von DOT11_PHY_ATTRIBUTES Strukturen angibt. Wenn der Miniport-Treiber NdisMSetMiniportAttributesaufruft, legt der Treiber den MiniportAttributes Parameter auf die Adresse des vom Treiber zugewiesenen Speicherblocks fest, der eine NDIS_MINIPORT_ADAPTER_NATIVE_802_11_ATTRIBUTES Struktur zusammen mit dem Array DOT11_PHY_ATTRIBUTES Struktur enthält.

Anforderungen

Anforderung	Wert
mindestens unterstützte Client-	Verfügbar in Windows Vista und höheren Versionen der Windows-Betriebssysteme.
Header-	windot11.h (include Ndis.h)