estrutura DOT11_BSS_ENTRY (windot11.h)
Importante
WiFiCx é o novo modelo de driver Wi-Fi lançado no Windows 11. Recomendamos que você use o WiFiCx para aproveitar os recursos mais recentes. O modelo de driver WDI agora está no modo de manutenção e receberá apenas correções de alta prioridade.
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 de PHY é o índice na 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 de mídia) do AP (ponto de acesso) (para redes BSS de infraestrutura) ou estação de 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 variando de 0 a 100. Um valor de 100 especifica a qualidade de vínculo mais alta. Para obter mais informações sobre como determinar a qualidade do link, consulte Link Quality Operations.
bInRegDomain
Este membro especifica se a AP ou a estação de 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 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 VERDADEIRO. Para obter mais informações sobre vários domínios regulatórios, consulte OID_DOT11_MULTI_DOMAIN_CAPABILITY_IMPLEMENTED.
- Se a cadeia de caracteres do país de entrada for todos zeros, defina o membro como VERDADEIRO.
- 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 VERDADEIRO.
Para obter mais informações sobre o IE do País, 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 do país de entrada.
- Defina o membro como VERDADEIRO em todos os outros casos.
usBeaconPeriod
O valor do campo Intervalo de Sinalizador 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[1]
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 sinalizador ou quadro 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 Resposta de Investigação ou Beacon recebido.
Quando a NIC estiver no modo OP do Ponto de Acesso Extensível (ExtAP), a lista BSS deverá conter uma entrada para o BSS que a NIC criou.
Para obter mais informações sobre os campos dentro dos quadros de Resposta de Investigação ou Beacon do IEEE 802.11, consulte a Cláusula 8.4 do padrão IEEE 802.11-2012.
Observações
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 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 miniporto retornará a lista dos quadros beacon e resposta de investigação em cache quando consultado por OID_DOT11_ENUM_BSS_LIST. Uma estrutura DOT11_BSS_ENTRY separada é formatada para cada quadro de Resposta de Sinalizador e Investigação.
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) |