estrutura DOT11_PHY_ATTRIBUTES (windot11.h)

Artigo
02/07/2025

Importante A interface de lan sem fio do Nativo 802.11 é preterida no Windows 10 e posterior. Em vez disso, use a WDI (Interface de Driver de Dispositivo) WLAN. Para obter mais informações sobre o WDI, consulte do modelo de driver Universal do Windows da WLAN.

A estrutura DOT11_PHY_ATTRIBUTES define os atributos físicos e operacionais de um PHY na estação 802.11.

Sintaxe

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;

Membros

Header

O tipo, a revisão e o tamanho da estrutura DOT11_PHY_ATTRIBUTES. Esse membro é formatado como uma estrutura NDIS_OBJECT_HEADER.

O driver de miniporto deve definir os membros do Header para os seguintes valores:

Tipo

Esse membro deve ser definido como NDIS_OBJECT_TYPE_DEFAULT.

Revisão

Esse membro deve ser definido como DOT11_PHY_ATTRIBUTES_REVISION_1.

Tamanho

Esse membro deve ser definido como sizeof(DOT11_PHY_ATTRIBUTES).

Para obter mais informações sobre esses membros, consulte NDIS_OBJECT_HEADER.

PhyType

O tipo do PHY, conforme especificado por um valor DOT11_PHY_TYPE enumerador.

bHardwarePhyState

Um valor booliano que especifica o estado de energia de hardware do PHY. Se VERDADEIRO, o estado de energia de hardware estará habilitado. Se FALSE, o estado de energia do hardware será desabilitado.

Para obter mais informações sobre o estado de energia de hardware do PHY, consulte OID_DOT11_HARDWARE_PHY_STATE.

Observação Sempre que o estado de energia de hardware do PHY for alterado, o driver de miniporto deverá fazer um NDIS_STATUS_DOT11_PHY_STATE_CHANGED indicação de status específico da mídia.

bSoftwarePhyState

Um valor booliano que especifica o estado de energia de software do PHY. Se VERDADEIRO, o estado de energia do software estará habilitado. Se FALSE, o estado de energia do software será desabilitado.

Para obter mais informações sobre o estado de energia de software do PHY, consulte OID_DOT11_NIC_POWER_STATE.

Observação Sempre que o estado de energia de software do PHY for alterado, o driver de miniporto deverá fazer um NDIS_STATUS_DOT11_PHY_STATE_CHANGED indicação de status específico da mídia.

bCFPollable

Um valor booliano que, se definido como TRUE, indica que a estação 802.11 dá suporte a quadros CF-Poll. Para obter mais informações sobre CF-Poll quadros, consulte a Cláusula 9.4 do padrão IEEE 802.11-2012.

Esse membro não é aplicável ao modo de operação ExtAP (Ponto de Acesso Extensível) e é ignorado quando a NIC está no modo ExtAP.

uMPDUMaxLength

O comprimento máximo, em bytes, de um quadro de MPDU (unidade de dados de protocolo mac) de controle de acesso de mídia que o PHY pode transmitir ou receber. Para obter mais informações, consulte OID_DOT11_MPDU_MAX_LENGTH.

Observação Sempre que o estado de energia do software do PHY for alterado, o driver de miniporto deverá fazer uma indicação de status específica da mídia NDIS_STATUS_DOT11_MPDU_MAX_LENGTH_CHANGED.

TempType

O intervalo de temperatura operacional do PHY, definido por meio de um valor de enumeração DOT11_TEMP_TYPE.

DiversitySupport

O tipo de diversidade de antena do PHY, definido por meio de um valor de enumeração DOT11_DIVERSITY_SUPPORT.

PhySpecificAttributes

PhySpecificAttributes.HRDSSSAttributes

Os atributos específicos de PHY de um tipo de PHY HRDSS (espectro de distribuição de sequência direta) de alta taxa. O driver de miniporto deve usar esse membro somente se o membro PhyType estiver definido como dot11_phy_type_hrdsss.

PhySpecificAttributes.OFDMAttributes

Os atributos específicos de PHY de um tipo PHY de divisão de frequência ortogonal (OFDM). O driver de miniporto deve usar esse membro somente se o membro PhyType estiver definido como dot11_phy_type_ofdm.

PhySpecificAttributes.ERPAttributes

Os atributos específicos de PHY de um tipo ERP (PHY de taxa estendida). O driver de miniporto deve usar esse membro somente se o membro do PhyType estiver definido como dot11_phy_type_erp.

Observações

O NDIS_MINIPORT_ADAPTER_NATIVE_802_11_ATTRIBUTES estrutura contém um membro (pExtPhyAttributes) que especifica o endereço de uma matriz de estruturas DOT11_PHY_ATTRIBUTES. Quando o driver de miniporto chama NdisMSetMiniportAttributes, o driver define o parâmetro MiniportAttributes para o endereço do bloco de memória alocado pelo driver que contém uma estrutura NDIS_MINIPORT_ADAPTER_NATIVE_802_11_ATTRIBUTES juntamente com a matriz de DOT11_PHY_ATTRIBUTES estrutura.

Requisitos

Requisito	Valor
de cliente com suporte mínimo	Disponível no Windows Vista e versões posteriores dos sistemas operacionais Windows.
cabeçalho	windot11.h (inclua Ndis.h)