estrutura DOT11_PHY_ATTRIBUTES (windot11.h)

Artigo
08/08/2023

Importante A interface lan sem fio Native 802.11 foi preterida no Windows 10 e posterior. Em vez disso, use a WDI (Interface de Driver de Dispositivo) da WLAN. Para obter mais informações sobre o WDI, consulte 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 miniporta deve definir os membros de 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 de enumerador DOT11_PHY_TYPE .

bHardwarePhyState

Um valor booliano que especifica o estado de energia de hardware do PHY. Se TRUE, o estado de energia do 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.

Nota 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ífica da mídia.

bSoftwarePhyState

Um valor booliano que especifica o estado de energia do software do PHY. Se TRUE, 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 do software da PHY, consulte OID_DOT11_NIC_POWER_STATE.

Nota Sempre que o estado de energia do software do PHY for alterado, o driver de miniporte deverá fazer um NDIS_STATUS_DOT11_PHY_STATE_CHANGED indicação de status específica 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 MPDU (unidade de dados de protocolo MAC) que o PHY pode transmitir ou receber. Para obter mais informações, consulte OID_DOT11_MPDU_MAX_LENGTH.

Nota Sempre que o estado de energia do software da PHY for alterado, o driver de miniporto deverá fazer uma indicação 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 antenas do PHY, definido por meio de um valor de enumeração DOT11_DIVERSITY_SUPPORT .

PhySpecificAttributes

PhySpecificAttributes.HRDSSSAttributes

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

PhySpecificAttributes.OFDMAttributes

Os atributos específicos do PHY de um tipo PHY de multiplexação 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 do PHY de um tipo ERP (PHY de taxa estendida). O driver de miniporta deve usar esse membro somente se o membro PhyType estiver definido como dot11_phy_type_erp.

Comentários

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 como 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
Cliente mínimo com suporte	Disponível no Windows Vista e versões posteriores dos sistemas operacionais Windows.
Cabeçalho	windot11.h (inclua Ndis.h)