struttura DOT11_PHY_ATTRIBUTES (windot11.h)

Important The Native 802.11 Wireless LAN interface is deprecated in Windows 10 and later. 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.

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;

Members

Header

Tipo, revisione e dimensione della struttura DOT11_PHY_ATTRIBUTES. This member is formatted as an NDIS_OBJECT_HEADER structure.

The miniport driver must set the members of Header to the following values:

Type

Questo membro deve essere impostato su NDIS_OBJECT_TYPE_DEFAULT.

Revision

Questo membro deve essere impostato su DOT11_PHY_ATTRIBUTES_REVISION_1.

Size

Questo membro deve essere impostato su sizeof(DOT11_PHY_ATTRIBUTES).

For more information about these members, see NDIS_OBJECT_HEADER.

PhyType

The type of the PHY as specified by a DOT11_PHY_TYPE enumerator value.

bHardwarePhyState

Valore booleano che specifica lo stato di alimentazione hardware del PHY. If TRUE, the hardware power state is enabled. If FALSE, the hardware power state is disabled.

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

Note Whenever the PHY's hardware power state changes, the miniport driver must make an NDIS_STATUS_DOT11_PHY_STATE_CHANGED media-specific status indication.

bSoftwarePhyState

Valore booleano che specifica lo stato di alimentazione software del PHY. If TRUE, the software power state is enabled. If FALSE, the software power state is disabled.

For more information about the PHY's software power state, see OID_DOT11_NIC_POWER_STATE.

Note Whenever the PHY's software power state changes, the miniport driver must make an NDIS_STATUS_DOT11_PHY_STATE_CHANGED media-specific status indication.

bCFPollable

A Boolean value that, if set to TRUE, indicates that the 802.11 station supports CF-Poll frames. 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. For more information, see OID_DOT11_MPDU_MAX_LENGTH.

Note Whenever the PHY's software power state changes, the miniport driver must make an NDIS_STATUS_DOT11_MPDU_MAX_LENGTH_CHANGED media-specific status indication.

TempType

The PHY's operating temperature range, defined through a DOT11_TEMP_TYPE enumeration value.

DiversitySupport

The PHY's type of antenna diversity, defined through a DOT11_DIVERSITY_SUPPORT enumeration value.

PhySpecificAttributes

PhySpecificAttributes.HRDSSSAttributes

Attributi specifici di PHY di un tipo PHY (Direct Sequence Spread Spectrum) ad alta frequenza. The miniport driver must use this member only if the PhyType member is set to 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). The miniport driver must use this member only if the PhyType member is set to dot11_phy_type_ofdm.

PhySpecificAttributes.ERPAttributes

Attributi specifici di PHY di un tipo ERP (Extended Rate PHY). The miniport driver must use this member only if the PhyType member is set to dot11_phy_type_erp.

Remarks

The NDIS_MINIPORT_ADAPTER_NATIVE_802_11_ATTRIBUTES structure contains a member (pExtPhyAttributes) that specifies the address of an array of DOT11_PHY_ATTRIBUTES structures. When the miniport driver calls NdisMSetMiniportAttributes, the driver sets the MiniportAttributes parameter to the address of driver-allocated block of memory which contains an NDIS_MINIPORT_ADAPTER_NATIVE_802_11_ATTRIBUTES structure along with the array of DOT11_PHY_ATTRIBUTES structure.

Requirements

Requirement Value
client minimo supportato Disponibile in Windows Vista e versioni successive dei sistemi operativi Windows.
Header windot11.h (include Ndis.h)

See also

DOT11_DIVERSITY_SUPPORT

DOT11_PHY_TYPE

DOT11_OFDM_PHY_ATTRIBUTES

DOT11_SUPPORTED_DATA_RATES_VALUE_V2

DOT11_ERP_PHY_ATTRIBUTES

OID_DOT11_NIC_POWER_STATE

OID_DOT11_HARDWARE_PHY_STATE

NdisMSetMiniportAttributes

NDIS_MINIPORT_ADAPTER_NATIVE_802_11_ATTRIBUTES

DOT11_TEMP_TYPE

DOT11_DATA_RATE_MAPPING_ENTRY

DOT11_HRDSSS_PHY_ATTRIBUTES

NDIS_OBJECT_HEADER