struttura DOT11_PHY_ATTRIBUTES (windot11.h)

Articolo
02/07/2025

importante L'interfaccia LAN wireless 802.1 1 nativa è 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 di Windows universale WLAN.

La struttura DOT11_PHY_ATTRIBUTES definisce gli attributi fisici e operativi di un PHY nella 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;

Membri

Header

Tipo, revisione e dimensione 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:

Digitare

Questo membro deve essere impostato su NDIS_OBJECT_TYPE_DEFAULT.

Revisione

Questo membro deve essere impostato su DOT11_PHY_ATTRIBUTES_REVISION_1.

Grandezza

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 lo stato di alimentazione hardware di PHY cambia, 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 software è abilitato. Se FALSE, lo stato di alimentazione 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 software di 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 CF-Poll frame. Per altre informazioni sui fotogrammi 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 software di PHY, il driver miniport deve fare un'indicazione di stato specifica del supporto NDIS_STATUS_DOT11_MPDU_MAX_LENGTH_CHANGED.

TempType

Intervallo di temperatura operativa di 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 di 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 di PHY di un tipo PHY di tipo PHY (PHY) di divisione multixing ortogonale.the PHY-specific attributes of an orthogonal frequency division multiplexing (OFDM). 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 un tipo ERP (Extended Rate PHY). Il driver miniport deve utilizzare questo membro solo se il membro PhyType è impostato su dot11_phy_type_erp.

Osservazioni

Le 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 della struttura DOT11_PHY_ATTRIBUTES.