estrutura DOT11_SCAN_REQUEST_V2 (windot11.h)
A estrutura DOT11_SCAN_REQUEST_V2 define os parâmetros para a operação de verificação explícita executada pela estação 802.11. A estação executa a operação de verificação explícita após uma solicitação de conjunto de OID de OID_DOT11_SCAN_REQUEST.
Sintaxe
typedef struct _DOT11_SCAN_REQUEST_V2 {
DOT11_BSS_TYPE dot11BSSType;
DOT11_MAC_ADDRESS dot11BSSID;
DOT11_SCAN_TYPE dot11ScanType;
BOOLEAN bRestrictedScan;
ULONG udot11SSIDsOffset;
ULONG uNumOfdot11SSIDs;
BOOLEAN bUseRequestIE;
ULONG uRequestIDsOffset;
ULONG uNumOfRequestIDs;
ULONG uPhyTypeInfosOffset;
ULONG uNumOfPhyTypeInfos;
ULONG uIEsOffset;
ULONG uIEsLength;
UCHAR ucBuffer[1];
} DOT11_SCAN_REQUEST_V2, *PDOT11_SCAN_REQUEST_V2;
Membros
dot11BSSType
O tipo de redes BSS (conjunto de serviços) básicas para as quais a estação 802.11 verifica. O tipo de dados desse membro é a enumeração DOT11_BSS_TYPE .
dot11BSSID
O BSS (identificador BSSID) de uma rede BSS para a qual a estação 802.11 verifica. Se esse membro estiver definido como o BSSID curinga (0xFFFFFFFFFFFF), a estação verificará todos os BSSIDs.
dot11ScanType
O tipo de verificação que a estação 802.11 executa. O tipo de dados desse membro é a enumeração DOT11_SCAN_TYPE, que declara os seguintes valores:
dot11_scan_type_active
A estação transmite um quadro de Solicitação de Investigação 802.11 em cada canal que examina. Ele fica no canal tempo suficiente para receber quadros de resposta de investigação 802.11 para sua Solicitação de Investigação. A estação também recebe 802.11 quadros beacon enviados no canal.
dot11_scan_type_passive
A estação não transmite um quadro de Solicitação de Investigação 802.11 em cada canal que examina. Em vez disso, ele recebe 802.11 quadros beacon ou solicitação de investigação enviados no canal.
dot11_scan_type_auto
A estação pode executar verificações ativas ou passivas ou pode usar uma combinação de ambos os tipos de verificação.
Independentemente do valor de dot11ScanType, a estação 802.11 deve executar um tipo de verificação de dot11_scan_type_passive sempre que verificar em canais que não são válidos no domínio regulatório atual. Além disso, a estação 802.11 deve executar um tipo de verificação de dot11_scan_type_passive se não tiver um domínio regulatório padrão. Para obter mais informações sobre domínios regulatórios, consulte OID_DOT11_CURRENT_REG_DOMAIN.
Se o dot11_scan_type_forced bit estiver definido no membro dot11ScanType , a estação 802.11 deverá executar uma verificação completa em todos os canais com suporte. Se o dot11_scan_type_forced bit não estiver definido, a estação 802.11 poderá executar uma verificação completa ou executar uma verificação parcial em um subconjunto dos canais com suporte.
bRestrictedScan
Se esse membro for TRUE, a estação 802.11 executará uma verificação restrita ao canal e à configuração de PHY usada para se conectar a uma rede BSS.
O driver de miniporte deve ignorar esse membro se qualquer um dos seguintes for verdadeiro:
- O driver de miniporto está operando no modo ExtSTA.
- A estação 802.11 não está conectada a uma rede BSS.
udot11SSIDsOffset
O deslocamento na matriz ucBuffer em que a lista SSID (identificador de conjunto de serviços) começa. Cada entrada na lista SSID é formatada como uma estrutura DOT11_SSID .
A estação 802.11 verifica cada SSID na lista. Por exemplo, se dot11ScanType estiver definido como dot11_scan_type_active, a estação 802.11 transmitirá uma Solicitação de Investigação 802.11 para cada SSID na lista durante a verificação em um canal.
uNumOfdot11SSIDs
O número de entradas na lista SSID.
Se uNumOfdot11SSIDs for zero, o driver de miniporto deverá usar uma lista SSID contendo o SSID de comprimento zero curinga.
bUseRequestIE
Se esse membro for TRUE, a estação 802.11 deverá incluir a lista de IDs de solicitação (definidas por meio dos membros uRequestIDsOffset e uNumOfRequestIDs ) dentro do elemento de informações de solicitação 802.11d (IE) de cada quadro de Solicitação de Investigação que ele transmite durante a verificação ativa.
O driver de miniporte deve ignorar esse membro (juntamente com os membros uRequestIDsOffset e uNumOfRequestIDs ) se qualquer um dos seguintes membros for verdadeiro:
- O driver de miniporto está operando no modo ExtSTA.
- O objeto 802.11 dot11MultiDomainCapabilityEnabled da base de informações de gerenciamento (MIB) é FALSE. Para obter mais informações sobre o objeto dot11MultiDomainCapabilityEnabled MIB, consulte OID_DOT11_MULTI_DOMAIN_CAPABILITY_ENABLED.
- O membro dot11ScanType está definido como dot11_scan_type_passive.
uRequestIDsOffset
O deslocamento na matriz ucBuffer em que a lista IDs de solicitação começa. Cada entrada na lista de IDs de solicitação é formatada como um tipo de dados UCHAR.
uNumOfRequestIDs
O número de entradas na lista de IDs de solicitação.
uPhyTypeInfosOffset
O deslocamento na matriz ucBuffer em que começa a lista de tipos de PHY. Cada entrada na lista de tipos PHY é formatada como uma estrutura DOT11_PHY_TYPE_INFO .
A estação 802.11 deve executar a verificação BSS usando cada um dos tipos de PHY especificados dessa lista.
O driver de miniporte deve ignorar esse membro (juntamente com o membro uNumOfPhyTypeInfos ) se bRestrictedScan estiver definido como TRUE.
uNumOfPhyTypeInfos
O número de entradas na lista de tipos de PHY.
Se uNumOfPhyTypeInfos for zero, a estação 802.11 executará a verificação usando todos os PHYs compatíveis.
uIEsOffset
O deslocamento na matriz ucBuffer em que começa a lista de IEs (elementos de informações de comprimento variável). A estação 802.11 deve acrescentar a lista de IEs ao final de cada quadro de Solicitação de Investigação que ele transmite durante uma verificação ativa.
O driver de miniporto deve ignorar esse membro (juntamente com o membro uIEsLength ) se dot11ScanType estiver definido como dot11_scan_type_passive.
uIEsLength
O comprimento, em bytes, da lista de IEs.
ucBuffer[1]
O buffer que contém dados opcionais conforme especificado por meio de outros membros dessa estrutura.
Comentários
A estação 802.11 executa operações de verificação explícitas após a solicitação de conjunto de OID de OID_DOT11_SCAN_REQUEST. A estação executa a operação de verificação usando os parâmetros definidos por meio da DOT11_SCAN_REQUEST_V2, que acompanha a solicitação definida.
Para obter mais informações sobre as operações de verificação executadas por um driver de miniporto Nativo 802.11, consulte Operações de verificação nativas 802.11.
Para obter mais informações sobre o modo de operação ExtSTA, consulte Modo extensível de operação de estaçã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) |