estrutura DOT11_BSS_ENTRY (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_BSS_ENTRY define um Beacon IEEE 802.11 ou Quadro de Resposta que a estação 802.11 recebeu durante sua última operação de verificação.

Sintaxe

typedef struct DOT11_BSS_ENTRY {
  ULONG                             uPhyId;
  DOT11_BSS_ENTRY_PHY_SPECIFIC_INFO PhySpecificInfo;
  DOT11_MAC_ADDRESS                 dot11BSSID;
  DOT11_BSS_TYPE                    dot11BSSType;
  LONG                              lRSSI;
  ULONG                             uLinkQuality;
  BOOLEAN                           bInRegDomain;
  USHORT                            usBeaconPeriod;
  ULONGLONG                         ullTimestamp;
  ULONGLONG                         ullHostTimestamp;
  USHORT                            usCapabilityInformation;
  ULONG                             uBufferLength;
  UCHAR                             ucBuffer[1];
} DOT11_BSS_ENTRY, *PDOT11_BSS_ENTRY;

Membros

uPhyId

O identificador (ID) do PHY que a estação 802.11 usou para detectar a rede BSS. A ID PHY é o índice dentro da lista de PHYs com suporte retornados pelo driver por meio de uma consulta de OID_DOT11_SUPPORTED_PHY_TYPES.

Essa ID não deve ser DOT11_PHY_ID_ANY.

PhySpecificInfo

Os atributos do PHY referenciados pelo membro uPhyId . PhySpecificInfo é formatado como um DOT11_BSS_ENTRY_PHY_SPECIFIC_INFO união.

dot11BSSID

O endereço MAC (controle de acesso à mídia) do ponto de acesso (AP) (para redes BSS de infraestrutura) ou estação par (para redes BSS independentes) que enviou o quadro 802.11 Beacon ou Probe Response recebido pela estação 802.11 durante a verificação. O tipo de dados desse membro é a estrutura DOT11_MAC_ADDRESS .

dot11BSSType

O tipo de rede BSS.

O tipo de dados desse membro é a enumeração DOT11_BSS_TYPE . O driver de miniporta não deve definir esse membro como o valor dot11_BSS_type_any .

lRSSI

O valor RSSI (indicador de intensidade de sinal recebido), em unidades de decibéis referenciadas a 1,0 miliwatts (dBm), conforme detectado pela estação 802.11 para a AP ou estação par.

uLinkQuality

O valor de qualidade do link variando de 0 a 100. Um valor de 100 especifica a mais alta qualidade do link. Para obter mais informações sobre como determinar a qualidade do link, consulte Operações de qualidade de link.

bInRegDomain

Esse membro especifica se a AP ou a estação par está operando dentro do domínio regulatório, conforme identificado pela cadeia de caracteres de país de entrada. Para definir esse membro, o driver de miniporto deve usar as seguintes diretrizes:

Se a estação 802.11 não der suporte a vários domínios regulatórios, defina o membro como TRUE. Para obter mais informações sobre vários domínios regulatórios, consulte OID_DOT11_MULTI_DOMAIN_CAPABILITY_IMPLEMENTED.
Se a cadeia de caracteres de país de entrada for todos zeros, defina o membro como TRUE.
Se a AP ou a estação par não estiver operando em um canal válido para o domínio regulatório especificado pela cadeia de caracteres de país de entrada, defina o membro como FALSE.
Se o quadro 802.11 Beacon ou Probe Response, que foi recebido da AP ou da estação par, não incluir um elemento de informações country (IE), defina o membro como TRUE.
Para obter mais informações sobre o Country IE, consulte a Cláusula 7.3.2.12 do padrão IEEE 802.11d-2001.
Se o quadro 802.11 Beacon ou Probe Response, que foi recebido da AP ou da estação par, incluir um Country IE, defina o membro como FALSE se o valor do subcampo Country String não for igual à cadeia de caracteres de país de entrada.
Defina o membro como TRUE em todos os outros casos.

usBeaconPeriod

O valor do campo Intervalo de Beacon do quadro 802.11 Beacon ou Resposta de Investigação.

ullTimestamp

O valor do campo Carimbo de data/hora do quadro beacon 802.11 ou resposta de investigação.

ullHostTimestamp

O carimbo de data/hora, resolvido por meio de uma chamada para NdisGetCurrentSystemTime, que registra quando a estação 802.11 recebeu o quadro 802.11 Beacon ou Probe Response.

usCapabilityInformation

O valor do campo Informações de Funcionalidade do quadro Beacon 802.11 ou Resposta de Investigação.

uBufferLength

O comprimento, em bytes, da matriz ucBuffer na estrutura DOT11_BSS_ENTRY. ulBufferLength deve ter o comprimento exato dos dados na matriz ucBuffer e não deve conter nenhum preenchimento para alinhamento.

ucBuffer[1]

Os IEs (elementos de informações de comprimento variável) dos quadros 802.11 Beacon ou Probe Response. Para cada BSS, os IEs devem ser do último quadro beacon ou resposta de investigação recebido dessa rede BSS. Se um IE estiver disponível em apenas um quadro, o driver de miniporto deverá mesclar o IE com os outros IEs do último quadro beacon recebido ou resposta de investigação.

Quando a NIC está no modo OP do Ponto de Acesso Extensível (ExtAP), a lista BSS deve conter uma entrada para o BSS que a NIC criou.

Para obter mais informações sobre os campos nos quadros Beacon ou Resposta de Investigação do IEEE 802.11, consulte a Cláusula 8.4 do padrão IEEE 802.11-2012.

Comentários

Quando a estação 802.11 executa uma operação de verificação, o driver de miniporto Native 802.11 armazena em cache os quadros 802.11 Beacon e Probe Response recebidos. Para obter mais informações sobre a operação de verificação, consulte Operações de verificação nativas 802.11.

Depois que a estação 802.11 concluir a operação de verificação, o driver de miniporta retornará a lista dos quadros Beacon e Probe Response armazenados em cache quando consultado por OID_DOT11_ENUM_BSS_LIST. Uma estrutura de DOT11_BSS_ENTRY separada é formatada para cada quadro beacon e resposta de investigação.

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)