estrutura DOT11_ASSOCIATION_COMPLETION_PARAMETERS (windot11.h)
Importante
A interface lan sem fio Nativa 802.11 foi preterida em Windows 10 e posteriores. Em vez disso, use a WDI (Interface do Driver de Dispositivo) WLAN. Para obter mais informações sobre o WDI, consulte WLAN Modelo de driver Universal do Windows.
A estrutura DOT11_ASSOCIATION_COMPLETION_PARAMETERS especifica os resultados da operação de associação executada pela estação 802.11 com um ponto de acesso (AP) ou uma estação par. O driver de miniporto Native 802.11 inclui uma estrutura DOT11_ASSOCIATION_COMPLETION_PARAMETERS quando o driver de miniporto faz uma indicação de status NDIS_STATUS_DOT11_ASSOCIATION_COMPLETION.
Sintaxe
typedef struct DOT11_ASSOCIATION_COMPLETION_PARAMETERS {
NDIS_OBJECT_HEADER Header;
DOT11_MAC_ADDRESS MacAddr;
DOT11_ASSOC_STATUS uStatus;
BOOLEAN bReAssocReq;
BOOLEAN bReAssocResp;
ULONG uAssocReqOffset;
ULONG uAssocReqSize;
ULONG uAssocRespOffset;
ULONG uAssocRespSize;
ULONG uBeaconOffset;
ULONG uBeaconSize;
ULONG uIHVDataOffset;
ULONG uIHVDataSize;
DOT11_AUTH_ALGORITHM AuthAlgo;
DOT11_CIPHER_ALGORITHM UnicastCipher;
DOT11_CIPHER_ALGORITHM MulticastCipher;
ULONG uActivePhyListOffset;
ULONG uActivePhyListSize;
BOOLEAN bFourAddressSupported;
BOOLEAN bPortAuthorized;
UCHAR ucActiveQoSProtocol;
DOT11_DS_INFO DSInfo;
ULONG uEncapTableOffset;
ULONG uEncapTableSize;
DOT11_CIPHER_ALGORITHM MulticastMgmtCipher;
ULONG uAssocComebackTime;
} DOT11_ASSOCIATION_COMPLETION_PARAMETERS, *PDOT11_ASSOCIATION_COMPLETION_PARAMETERS;
Membros
Header
O tipo, a revisão e o tamanho da estrutura DOT11_ASSOCIATION_COMPLETION_PARAMETERS. Esse membro é formatado como uma estrutura NDIS_OBJECT_HEADER .
O driver de miniporte deve definir os membros de Cabeçalho para os seguintes valores:
Tipo
Esse membro deve ser definido como NDIS_OBJECT_TYPE_DEFAULT.
Revisão
Esse membro deve ser definido como DOT11_ASSOCIATION_COMPLETION_PARAMETERS_REVISION_1.
Tamanho
Esse membro deve ser definido como sizeof(DOT11_ASSOCIATION_COMPLETION_PARAMETERS).
Para obter mais informações sobre esses membros, consulte NDIS_OBJECT_HEADER.
MacAddr
O endereço MAC (controle de acesso à mídia) do AP (ponto de acesso) (para redes BSS de infraestrutura) ou estação par (para redes independentes de BSS (IBSS) às quais a estação 802.11 tentou se conectar.
uStatus
O status de conclusão da operação de associação, conforme especificado por um valor definido para DOT11_ASSOC_STATUS.
bReAssocReq
Um valor booliano que indica se a estação 802.11 enviou um quadro 802.11 Association ou Reassociation para a AP. Se TRUE, a estação 802.11 enviou um quadro 801.11 Solicitação de Reassociação para a AP. Se FALSE, a estação 802.11 enviou um quadro de Solicitação de Associação 802.11 para a AP.
Um valor TRUE para o membro bReAssocReq só será válido se o objeto dot11DesiredBSSType MIB for definido como dot11_BSS_type_infrastructure.
bReAssocResp
Um valor booliano que indica se a estação 802.11 recebeu um quadro 802.11 Association ou Reassociation da AP. Se TRUE, a estação 802.11 recebeu um quadro 802.11 Reassociation Response da AP. Se FALSE, a estação 802.11 recebeu um quadro 802.11 Association Response da AP.
Um valor true para o membro bReAssocResp só será válido se o objeto dot11DesiredBSSType MIB estiver definido como dot11_BSS_type_infrastructure.
uAssocReqOffset
O deslocamento do quadro de solicitação usado na operação de associação. O quadro não inclui o cabeçalho MAC 802.11.
Esse deslocamento é relativo ao início do buffer que contém a estrutura DOT11_ASSOCIATION_COMPLETION_PARAMETERS.
O quadro Solicitação de Associação retornado pelo driver de miniporto depende da configuração do objeto MIB IEEE 802.11 dot11DesiredBSSType :
- Se o objeto dot11DesiredBSSType MIB estiver definido como dot11_BSS_type_infrastructure, o quadro será o quadro 802.11 Association Request (se bReAssocReq for FALSE) ou o quadro Solicitação de Reassociação (se bReAssocReq for TRUE) que foi enviado à AP. O driver de miniporto deve retornar um quadro de Solicitação de Investigação 802.11 que seja enviado pelo iniciador de associação ou criado pelo driver com base nas informações que foram trocadas durante a operação de associação.
- Se o objeto dot11DesiredBSSType MIB estiver definido como dot11_BSS_type_independent, o driver de miniporto deverá definir o membro uAssocReqOffset como zero.
O driver de miniporte deve definir os membros uAssocReqOffset e uAssocReqSize como zero se não for possível enviar um quadro de solicitação durante a operação de associação. Por exemplo, se a AP falhou no quadro de Autenticação 802.11 que foi enviado pela estação 802.11, o driver de miniporto deverá definir uAssocReqOffset e uAssocReqSize como zero.
uAssocReqSize
O comprimento do quadro de solicitação usado na operação de associação. O comprimento do quadro não inclui o cabeçalho MAC 802.11.
Se o objeto dot11DesiredBSSType MIB estiver definido como dot11_BSS_type_independent, o driver de miniporto deverá definir o membro uAssocReqSize como zero.
uAssocRespOffset
O deslocamento do quadro de resposta usado na operação de associação. O quadro não inclui o cabeçalho MAC 802.11.
Esse deslocamento é relativo ao início do buffer, que contém a estrutura DOT11_ASSOCIATION_COMPLETION_PARAMETERS.
O quadro de resposta de associação retornado pelo driver de miniporto depende da configuração do objeto MIB IEEE 802.11 dot11DesiredBSSType :
Se o objeto dot11DesiredBSSType MIB estiver definido como dot11_BSS_type_infrastructure, o quadro será o quadro 802.11 Association Response (se bReAssocReq for TRUE) ou o quadro Reassociation Response (se bReAssocReq for FALSE) que foi recebido da AP. O driver de miniporto deve retornar um quadro 802.11 Probe Response que seja enviado para o iniciador de associação ou criado pelo driver com base nas informações trocadas durante a operação de associação.
Se o objeto dot11DesiredBSSType MIB estiver definido como dot11_BSS_type_independent, o driver de miniporto deverá definir o membro uAssocRespOffset como zero.
O driver de miniporte deve definir os membros uAssocRespOffset e uAssocRespSize como zero se ele não recebeu um quadro de resposta durante a operação de associação.
uAssocRespSize
O comprimento do quadro de resposta usado na operação de associação. O comprimento do quadro não inclui o cabeçalho MAC 802.11.
Se o objeto dot11DesiredBSSType MIB estiver definido como dot11_BSS_type_independent, o driver de miniporto deverá definir o membro uAssocRespSize como zero.
uBeaconOffset
O deslocamento do último recebeu 802.11 quadros beacon ou de resposta de investigação. O driver de miniporto deve excluir o cabeçalho MAC 802.11 para esses quadros ao fazer o NDIS_STATUS_DOT11_ASSOCIATION_COMPLETION status indicação.
Esse deslocamento é relativo ao início do buffer, que contém a estrutura DOT11_ASSOCIATION_COMPLETION_PARAMETERS.
Observação
Se o algoritmo de autenticação usado na associação foi Wi-Fi WPA (Acesso Protegido) ou IEEE 802.11i Robust Security Network Association (RSNA), o driver de miniporto sempre deve retornar o último quadro beacon recebido 802.11 e não deve definir os membros uBeaconOffset e uBeaconSize como zero.
uBeaconSize
O comprimento do último quadro de Beacon recebeu 802.11. O comprimento do quadro não inclui o cabeçalho MAC 802.11.
uIHVDataOffset
O deslocamento de um bloco de dados em um formato proprietário definido pelo IHV. O IHV pode usar esse bloco de dados para quaisquer finalidades relacionadas à indicação status NDIS_STATUS_DOT11_ASSOCIATION_COMPLETION.
Esse deslocamento é relativo ao início do buffer, que contém a estrutura DOT11_ASSOCIATION_COMPLETION_PARAMETERS.
Se o driver de miniporto não estiver retornando dados IHV no NDIS_STATUS_DOT11_ASSOCIATION_COMPLETION status indicação, ele deverá definir uIHVDataOffset como zero.
uIHVDataSize
O comprimento do bloco de dados usado pelo IHV para a indicação de status NDIS_STATUS_DOT11_ASSOCIATION_COMPLETION. Se o driver de miniporto não estiver retornando dados IHV nessa indicação, ele deverá definir uIHVDataSize como zero.
AuthAlgo
O algoritmo de autenticação que a estação 802.11 resolveu com a AP ou a estação par durante a operação de associação. Para obter mais informações sobre o tipo de dados do membro AuthAlgo , consulte DOT11_AUTH_ALGORITHM.
O driver de miniporte deve definir esse membro como zero se uStatus não estiver definido como DOT11_ASSOCIATION_STATUS_SUCCESS.
UnicastCipher
O algoritmo de codificação unicast que a estação 802.11 resolveu com a AP ou a estação par durante a operação de associação. Para obter mais informações sobre o tipo de dados para o membro UnicastCipher , consulte DOT11_CIPHER_ALGORITHM.
O driver de miniporte deve definir esse membro como zero se uStatus não estiver definido como DOT11_ASSOCIATION_STATUS_SUCCESS.
MulticastCipher
O algoritmo de criptografia multicast que a estação 802.11 resolveu com a AP ou a estação par durante a operação de associação. Para obter mais informações sobre o tipo de dados para o membro MulticastCipher , consulte DOT11_CIPHER_ALGORITHM
O driver de miniporte deve definir esse membro como zero se uStatus não estiver definido como DOT11_ASSOCIATION_STATUS_SUCCESS.
uActivePhyListOffset
O deslocamento da lista de IDs (identificadores PHY) que a estação 802.11 usa para enviar ou receber pacotes na conexão de rede BSS.
O objeto MIB Extensible Station (ExtSTA) msDot11ActivePhyList também faz referência à lista PHY ativa.
Para obter mais informações sobre esse objeto MIB, consulte OID_DOT11_ACTIVE_PHY_LIST.
As entradas na lista PHY ativa podem ser um dos seguintes valores:
- Uma ID de PHY especificada pelo objeto ExtSTA msDot11DesiredPhyList MIB. Para obter mais informações sobre esse objeto MIB, consulte OID_DOT11_DESIRED_PHY_LIST.
- DOT11_PHY_ID_ANY. O driver de miniporto poderá definir uma entrada para esse valor se o objeto MIB msDot11ActivePhyList especificar todas as IDs de PHY especificadas pelo objeto MIB msDot11DesiredPhyList . Uma entrada com o valor de DOT11_PHY_ID_ANY deve ser a única entrada na lista PHY ativa.
O deslocamento da lista PHY ativa é relativo ao início do buffer que contém a estrutura DOT11_ASSOCIATION_COMPLETION_PARAMETERS.
O driver de miniporte deve definir os membros uActivePhyListOffset e uActivePhyListSize como zero se uStatus não estiver definido como DOT11_ASSOCIATION_STATUS_SUCCESS.
uActivePhyListSize
O comprimento da lista PHY ativa. O membro uActivePhyListSize deve ser um múltiplo de sizeof(ULONG).
bFourAddressSupported
Um valor booliano que, se definido como TRUE, especifica que a estação 802.11 se associou a uma AP que dá suporte a serviços do sistema de distribuição (DS) para a ponte iso camada 2 em qualquer estação na rede BSS, incluindo estações móveis e APs. A determinação desse suporte é específica para a implementação pelo IHV.
Um driver de miniporte deve definir o membro bFourAddressSupported comoFALSE se qualquer um dos seguintes for verdadeiro:
- O objeto IEEE 802.11 dot11DesiredBSSType MIB está definido como dot11_BSS_type_independent.
- A estação 802.11 não se associou a uma AP que dá suporte a serviços DS ou não pode determinar se a AP dá suporte a serviços DS.
- O membro uStatus não está definido como DOT11_ASSOCIATION_STATUS_SUCCESS.
bPortAuthorized
Um valor booliano que, se definido como TRUE, especifica que a estação 802.11 executou com êxito a autorização de porta durante a operação de associação. A autorização de porta pode ser baseada nos padrões IEEE 802.1X/802.11i ou em um algoritmo proprietário desenvolvido pelo IHV.
O driver de miniporte deve definir bPortAuthorized como FALSE se qualquer um dos seguintes itens for verdadeiro:
- A estação 802.11 não executa autorização de porta.
- O membro uStatus não está definido como DOT11_ASSOCIATION_STATUS_SUCCESS.
Para obter mais informações sobre autorização de porta, consulte Acesso à rede baseado em porta.
ucActiveQoSProtocol
Um sinalizador que especifica o protocolo QoS (qualidade de serviço) que está atualmente ativo para essa associação. Esse membro é zero (indicando que nenhum protocolo QoS está ativo) ou um dos seguintes sinalizadores:
DOT11_QOS_PROTOCOL_FLAG_WMM
A NIC está usando o protocolo QoS do WMM 802.11.
DOT11_QOS_PROTOCOL_FLAG_11E
A NIC está usando o protocolo QoS 802.11e.
DSInfo
Um valor DOT11_DS_INFO que especifica se a estação 802.11 está conectada ao mesmo DS da operação de associação anterior.
O membro DSInfo é formatado como uma enumeração DOT11_DS_INFO, que especifica os seguintes valores:
DOT11_DS_CHANGED
A estação 802.11 se conectou a um novo DS após a operação de associação.
DOT11_DS_UNCHANGED
A estação 802.11 está conectada ao mesmo DS da operação de associação.
DOT11_DS_UNKNOWN
O driver de miniporte não pode determinar se o DS foi alterado após a operação de associação.
Observação
O driver de miniporto deve definir DSInfo como DOT11_DS_UNKNOWN se o objeto dot11DesiredBSSType MIB estiver definido como dot11_BSS_type_independent.
uEncapTableOffset
O deslocamento da lista de encapsulamentos EtherType do IEEE para a associação BSS.
Esse deslocamento é relativo ao início do buffer, que contém a estrutura DOT11_ASSOCIATION_COMPLETION_PARAMETERS. O valor de uEncapTableOffset deve ser alinhado em um limite de 4 bytes.
O driver de miniporta formata cada entrada nesta lista como uma estrutura DOT11_ENCAP_ENTRY .
Para obter mais informações sobre a lista de encapsulamento EtherType, consulte Encapsulamento de carga 802.11.
uEncapTableSize
O comprimento da lista de encapsulamento EtherType.
MulticastMgmtCipher
O algoritmo de criptografia multicast que a NIC escolhe (negocia) para a associação para proteção de quadro de gerenciamento (MFP). Se o MFP for negociado, esse membro deverá ser DOT11_CIPHER_ALGO_BIP. Se o MFP não for negociado, esse campo deverá ser DOT11_CIPHER_ALGO_NONE.
uAssocComebackTime
Quando uma (re)associação falhar com o código de motivo 802.11 30 ("Solicitação de associação rejeitada temporariamente, tente novamente mais tarde.") esse membro indica o valor do tempo de retorno de associação solicitado pelo ponto de acesso (AP). O código de motivo de desassociação 802.11 está presente nos 16 bits mais baixos de uStatus ao responder a uma solicitação de associação.
O serviço de conexão automática do Windows adicionará a AP a uma lista bloqueada e não tentará se reconectar pelo menos pelo tempo de retorno indicado. A NIC se comportará como uma autenticação com falha regular até que a próxima sequência de conexão seja iniciada. Após o tempo limite indicado(retorno) decorrido e o processo de conexão for interrompido, o Windows poderá encontrar uma conexão alternativa melhor ou voltar para essa conexão. Esse valor definido neste membro deve usar as unidades de tempo definidas na especificação 802.11. Por exemplo, TU.
Comentários
O driver de miniporte deve definir os membros uEncapTableOffset e uEncapTableSize como zero se qualquer um dos seguintes membros for verdadeiro:
- A associação BSS não requer alterações na lista padrão de encapsulamentos EtherType do sistema operacional.
- O membro uStatus não está definido como DOT11_ASSOCIATION_STATUS_SUCCESS.
- O objeto dot11DesiredBSSType (Base de informações de gerenciamento) da Estação Extensível (ExtSTA) está definido como dot11_BSS_type_independent.
Para obter mais informações sobre o objeto IEEE 802.11 dot11DesiredBSSType MIB, consulte OID_DOT11_DESIRED_BSS_TYPE.
Para obter mais informações sobre a operação de associação, consulte Operações de associação.
A Proteção de Quadro de Gerenciamento é negociada quando um PONTO de acesso (AP) e STA definem o campo MFPC (Capacidade de Proteção de Quadro de Gerenciamento) como 1 em seus respectivos IEs RSN durante o (re)procedimento de associação (ou seja, O Beacon ou a Resposta de Investigação para AP e (re)solicitação de associação para STA) e ambas as partes confirmam o bit Compatível com Proteção de Quadro de Gerenciamento definido como 1 no Handshake 4-Way (Mensagens M2 e M3 do handshake de 4 vias 802.11i).
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte | Disponível em Windows 8 e versões posteriores dos sistemas operacionais Windows. |
| Cabeçalho | windot11.h (inclua Ndis.h) |