struttura DOT11_PHY_ATTRIBUTES (windot11.h)

Articolo
03/05/2024

Importante L'interfaccia LAN wireless native 802.11 è deprecata in Windows 10 e versioni successive. Usare invece l'interfaccia WDI (WLAN Device Driver Interface). Per altre informazioni su WDI, vedere Modello di driver WINDOWS universale WLAN.

La struttura DOT11_PHY_ATTRIBUTES definisce gli attributi fisici e operativi di un PHY sulla stazione 802.11.

Sintassi

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;

Members

Header

Tipo, revisione e dimensioni della struttura DOT11_PHY_ATTRIBUTES. Questo membro viene formattato come struttura NDIS_OBJECT_HEADER .

Il driver miniport deve impostare i membri di Header sui valori seguenti:

Tipo

Questo membro deve essere impostato su NDIS_OBJECT_TYPE_DEFAULT.

Revisione

Questo membro deve essere impostato su DOT11_PHY_ATTRIBUTES_REVISION_1.

Dimensione

Questo membro deve essere impostato su sizeof(DOT11_PHY_ATTRIBUTES).

Per altre informazioni su questi membri, vedere NDIS_OBJECT_HEADER.

PhyType

Tipo di PHY specificato da un valore enumeratore DOT11_PHY_TYPE .

bHardwarePhyState

Valore booleano che specifica lo stato di alimentazione hardware del PHY. Se TRUE, lo stato di alimentazione hardware è abilitato. Se FALSE, lo stato di alimentazione hardware è disabilitato.

Per altre informazioni sullo stato di alimentazione hardware di PHY, vedere OID_DOT11_HARDWARE_PHY_STATE.

Nota Ogni volta che cambia lo stato di alimentazione hardware del PHY, il driver miniport deve apportare un NDIS_STATUS_DOT11_PHY_STATE_CHANGED indicazione di stato specifica del supporto.

bSoftwarePhyState

Valore booleano che specifica lo stato di alimentazione software del PHY. Se TRUE, lo stato di alimentazione del software è abilitato. Se FALSE, lo stato di alimentazione del software è disabilitato.

Per altre informazioni sullo stato di alimentazione software di PHY, vedere OID_DOT11_NIC_POWER_STATE.

Nota Ogni volta che cambia lo stato di alimentazione del software PHY, il driver miniport deve apportare un NDIS_STATUS_DOT11_PHY_STATE_CHANGED indicazione di stato specifica del supporto.

bCFPollable

Valore booleano che, se impostato su TRUE, indica che la stazione 802.11 supporta i fotogrammi CF-Poll. Per altre informazioni sui frame di CF-Poll, vedere la clausola 9.4 dello standard IEEE 802.11-2012.

Questo membro non è applicabile alla modalità operativa ExtAP (Extensible Access Point) e viene ignorato quando la scheda di interfaccia di rete è in modalità ExtAP.

uMPDUMaxLength

Lunghezza massima, in byte, di un frame MPDU (Media Access Control) che il PHY può trasmettere o ricevere. Per altre informazioni, vedere OID_DOT11_MPDU_MAX_LENGTH.

Nota Ogni volta che cambia lo stato di alimentazione del software PHY, il driver miniport deve creare un NDIS_STATUS_DOT11_MPDU_MAX_LENGTH_CHANGED indicazione di stato specifica del supporto.

TempType

Intervallo di temperatura operativa del PHY, definito tramite un valore di enumerazione DOT11_TEMP_TYPE .

DiversitySupport

Il tipo di diversità dell'antenna PHY, definito tramite un valore di enumerazione DOT11_DIVERSITY_SUPPORT .

PhySpecificAttributes

PhySpecificAttributes.HRDSSSAttributes

Attributi specifici del PHY di un tipo PHY (Direct Sequence Spread Spectrum) ad alta frequenza. Il driver miniport deve utilizzare questo membro solo se il membro PhyType è impostato su dot11_phy_type_hrdsss.

PhySpecificAttributes.OFDMAttributes

Attributi specifici del PHY di un tipo PHY (PHY) di tipo PHY di divisione di frequenza ortogonale. Il driver miniport deve utilizzare questo membro solo se il membro PhyType è impostato su dot11_phy_type_ofdm.

PhySpecificAttributes.ERPAttributes

Attributi specifici di PHY di tipo ERP (Extended Rate PHY). Il driver miniport deve utilizzare questo membro solo se il membro PhyType è impostato su dot11_phy_type_erp.

Commenti

The NDIS_MINIPORT_ADAPTER_NATIVE_802_11_ATTRIBUTES struttura contiene un membro (pExtPhyAttributes) che specifica l'indirizzo di una matrice di strutture DOT11_PHY_ATTRIBUTES. Quando il driver miniport chiama NdisMSetMiniportAttributes, il driver imposta il parametro MiniportAttributes sull'indirizzo del blocco di memoria allocato dal driver che contiene una struttura NDIS_MINIPORT_ADAPTER_NATIVE_802_11_ATTRIBUTES insieme alla matrice di DOT11_PHY_ATTRIBUTES struttura.

Requisiti

Requisito	Valore
Client minimo supportato	Disponibile in Windows Vista e versioni successive dei sistemi operativi Windows.
Intestazione	windot11.h (include Ndis.h)