DOT11_BSS_ENTRY estrutura (windot11.h)

Importante A interface LAN sem fio Native 802.11 é preterida em Windows 10 e posteriores. Em vez disso, use a WDI (Interface do Driver de Dispositivo) do WLAN. Para obter mais informações sobre o WDI, consulte o modelo de driver universal do Windows WLAN.
 
A estrutura DOT11_BSS_ENTRY define um Sinalizador 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 miniporto não deve definir esse membro como o valor dot11_BSS_type_any .

lRSSI

O valor RSSI (indicador de força de sinal recebido), em unidades de decibéis referenciados 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 varia 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 do 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 do país de entrada. Para definir esse membro, o driver de miniport 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 do país (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 Probe Response.

ullTimestamp

O valor do campo Carimbo de data/hora do quadro 802.11 Beacon ou Probe Response.

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 802.11 Beacon ou Probe Response.

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

Os elementos de informações de comprimento variável (IEs) dos quadros 802.11 Beacon ou Probe Response. Para cada BSS, os IEs devem ser do último quadro beacon ou de 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 de Beacon ou Resposta de Investigação recebido.

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 de Resposta de Investigação ou Sinalizador 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 Nativo 802.11 armazena em cache os quadros de Resposta de Investigação e Sinalizador 802.11 recebidos. Para obter mais informações sobre a operação de verificação, consulte Operações de Verificação do Native 802.11.

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

Requisitos

   
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)

Confira também

DOT11_BSS_TYPE

DOT11_BSS_LIST

OID_DOT11_SUPPORTED_PHY_TYPES

OID_DOT11_MULTI_DOMAIN_CAPABILITY_IMPLEMENTED

DOT11_MAC_ADDRESS

DOT11_BSS_ENTRY_PHY_SPECIFIC_INFO

NdisGetCurrentSystemTime

OID_DOT11_ENUM_BSS_LIST