estructura DOT11_PHY_ATTRIBUTES (windot11.h)

Artículo
03/05/2024

Importante La interfaz LAN inalámbrica nativa 802.11 está en desuso en Windows 10 y versiones posteriores. En su lugar, use la interfaz del controlador de dispositivo WLAN (WDI). Para obtener más información sobre WDI, consulta Modelo de controlador de Windows universal WLAN.

La estructura DOT11_PHY_ATTRIBUTES define los atributos físicos y operativos de un PHY en la estación 802.11.

Sintaxis

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;

Miembros

Header

Tipo, revisión y tamaño de la estructura de DOT11_PHY_ATTRIBUTES. Este miembro tiene el formato de estructura NDIS_OBJECT_HEADER .

El controlador de minipuerto debe establecer los miembros de Header en los valores siguientes:

Tipo

Este miembro debe establecerse en NDIS_OBJECT_TYPE_DEFAULT.

Revisión

Este miembro debe establecerse en DOT11_PHY_ATTRIBUTES_REVISION_1.

Size

Este miembro debe establecerse en sizeof(DOT11_PHY_ATTRIBUTES).

Para obtener más información sobre estos miembros, vea NDIS_OBJECT_HEADER.

PhyType

Tipo del PHY especificado por un DOT11_PHY_TYPE valor de enumerador.

bHardwarePhyState

Valor booleano que especifica el estado de energía de hardware de PHY. Si es TRUE, el estado de alimentación de hardware está habilitado. Si es FALSE, el estado de alimentación del hardware está deshabilitado.

Para obtener más información sobre el estado de energía de hardware de PHY, consulte OID_DOT11_HARDWARE_PHY_STATE.

Nota Siempre que cambie el estado de energía del hardware de PHY, el controlador de minipuerto debe realizar una NDIS_STATUS_DOT11_PHY_STATE_CHANGED indicación de estado específica de los medios.

bSoftwarePhyState

Valor booleano que especifica el estado de energía de software de PHY. Si es TRUE, el estado de energía de software está habilitado. Si es FALSE, el estado de energía de software está deshabilitado.

Para obtener más información sobre el estado de energía de software de PHY, consulte OID_DOT11_NIC_POWER_STATE.

Nota Siempre que cambie el estado de energía del software de PHY, el controlador de minipuerto debe realizar una NDIS_STATUS_DOT11_PHY_STATE_CHANGED indicación de estado específica de los medios.

bCFPollable

Valor booleano que, si se establece en TRUE, indica que la estación 802.11 admite marcos CF-Poll. Para obtener más información sobre CF-Poll fotogramas, consulte la Cláusula 9.4 del estándar IEEE 802.11-2012.

Este miembro no es aplicable al modo de operación de punto de acceso extensible (ExtAP) y se omite cuando la NIC está en modo ExtAP.

uMPDUMaxLength

La longitud máxima, en bytes, de un marco de unidad de datos del protocolo de control de acceso multimedia (MAC) (MPDU) que el PHY puede transmitir o recibir. Para obtener más información, consulte OID_DOT11_MPDU_MAX_LENGTH.

Nota Siempre que cambie el estado de energía del software de PHY, el controlador de minipuerto debe realizar una indicación de estado NDIS_STATUS_DOT11_MPDU_MAX_LENGTH_CHANGED específica del medio.

TempType

El intervalo de temperatura de funcionamiento de PHY, definido a través de un valor de enumeración DOT11_TEMP_TYPE .

DiversitySupport

El tipo de diversidad de antenas de PHY, definido a través de un valor de enumeración DOT11_DIVERSITY_SUPPORT .

PhySpecificAttributes

PhySpecificAttributes.HRDSSSAttributes

Los atributos específicos de PHY de un tipo PHY de espectro de propagación de secuencia directa de alta velocidad (HRDSS). El controlador de minipuerto solo debe usar este miembro si el miembro PhyType está establecido en dot11_phy_type_hrdsss.

PhySpecificAttributes.OFDMAttributes

Atributos específicos de PHY de un tipo PHY de multiplexación de división de frecuencia ortogonal (OFDM). El controlador de minipuerto solo debe usar este miembro si el miembro PhyType está establecido en dot11_phy_type_ofdm.

PhySpecificAttributes.ERPAttributes

Los atributos específicos de PHY de un tipo PHY de velocidad extendida (ERP). El controlador de minipuerto solo debe usar este miembro si el miembro PhyType está establecido en dot11_phy_type_erp.

Comentarios

The NDIS_MINIPORT_ADAPTER_NATIVE_802_11_ATTRIBUTES estructura contiene un miembro (pExtPhyAttributes) que especifica la dirección de una matriz de estructuras de DOT11_PHY_ATTRIBUTES. Cuando el controlador de minipuerto llama a NdisMSetMiniportAttributes, el controlador establece el parámetro MiniportAttributes en la dirección del bloque de memoria asignado por el controlador que contiene una estructura NDIS_MINIPORT_ADAPTER_NATIVE_802_11_ATTRIBUTES junto con la matriz de DOT11_PHY_ATTRIBUTES estructura.

Requisitos

Requisito	Value
Cliente mínimo compatible	Disponible en Windows Vista y versiones posteriores de los sistemas operativos Windows.
Encabezado	windot11.h (incluye Ndis.h)