DOT11_PHY_ATTRIBUTES-Struktur (windot11.h)

Artikel
08/08/2023

Wichtig 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-Treibermodell.

Die DOT11_PHY_ATTRIBUTES-Struktur definiert die physischen und operativen Attribute 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;

Member

Header

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

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

Typ

Dieser Member muss auf NDIS_OBJECT_TYPE_DEFAULT festgelegt werden.

Revision

Dieses Element muss auf DOT11_PHY_ATTRIBUTES_REVISION_1 festgelegt werden.

Size

Dieser Member muss auf sizeof(DOT11_PHY_ATTRIBUTES) festgelegt werden.

Weitere Informationen zu diesen Membern finden Sie unter NDIS_OBJECT_HEADER.

PhyType

Der Typ des PHY, der durch einen DOT11_PHY_TYPE Enumeratorwert angegeben wird.

bHardwarePhyState

Ein boolescher Wert, der den Hardwareleistungsstatus des PHY angibt. Bei TRUE ist der Hardwareleistungszustand aktiviert. Bei FALSE ist der Hardwareleistungszustand deaktiviert.

Weitere Informationen zum Hardwareleistungszustand des PHY finden Sie unter OID_DOT11_HARDWARE_PHY_STATE.

Hinweis Wenn sich der Hardwareleistungszustand des PHY ändert, muss der Miniporttreiber einen NDIS_STATUS_DOT11_PHY_STATE_CHANGED medienspezifischen status Indikation.

bSoftwarePhyState

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

Weitere Informationen zum Softwareleistungsstatus 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 medienspezifischen status Indikation.

bCFPollable

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

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

uMPDUMaxLength

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

Hinweis Immer wenn sich der Softwareleistungszustand des PHY ändert, muss der Miniporttreiber eine NDIS_STATUS_DOT11_MPDU_MAX_LENGTH_CHANGED medienspezifischen status anzeigen.

TempType

Der Betriebstemperaturbereich des PHY, definiert durch einen DOT11_TEMP_TYPE Enumerationswert.

DiversitySupport

Der Typ der Antennendiversität des PHY, definiert durch einen DOT11_DIVERSITY_SUPPORT Enumerationswert.

PhySpecificAttributes

PhySpecificAttributes.HRDSSSAttributes

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

PhySpecificAttributes.OFDMAttributes

Die PHY-spezifischen Attribute eines ORTHOGONAL Frequency Division Multiplexings (OFDM) PHY-Typs. Der Miniporttreiber darf diesen Member nur verwenden, wenn das PhyType-Element auf dot11_phy_type_ofdm festgelegt ist.

PhySpecificAttributes.ERPAttributes

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

Hinweise

The 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 Miniporttreiber NdisMSetMiniportAttributes aufruft, 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
Unterstützte Mindestversion (Client)	Verfügbar in Windows Vista und höheren Versionen der Windows-Betriebssysteme.
Kopfzeile	windot11.h (include Ndis.h)