DOT11_BSS_ENTRY estrutura (windot11.h)
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[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 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) |