estrutura DOT11_ASSOCIATION_COMPLETION_PARAMETERS (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_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 de par. O driver de miniporto Nativo 802.11 inclui uma estrutura de 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 miniporto deve definir os membros do Header 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 de 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 de Associação ou Reassociação 802.11 para a AP. Se verdadeiro, a estação 802.11 enviou um quadro de Solicitação de Reassociação 801.11 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 de TRUE para o membro bReAssocReq é válido somente se o objeto dot11DesiredBSSType MIB estiver definido como dot11_BSS_type_infrastructure.
bReAssocResp
Um valor booliano que indica se a estação 802.11 recebeu um quadro de Associação ou Reassociação 802.11 da AP. Se verdadeiro, a estação 802.11 recebeu um quadro de Resposta de Reassociação 802.11 da AP. Se FALSE, a estação 802.11 recebeu um quadro de resposta de associação 802.11 da AP.
Um valor de TRUE para o membro bReAssocResp será válido somente 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 de DOT11_ASSOCIATION_COMPLETION_PARAMETERS.
O quadro solicitação de associação retornado pelo driver de miniporto depende da configuração do objeto MIB do iEEE 802.11 dot11DesiredBSSType:
- Se o objeto dot11DesiredBSSType MIB estiver definido como dot11_BSS_type_infrastructure, o quadro é 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 para a 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 do miniport deve definir o uAssocReqOffset e membros do 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 de DOT11_ASSOCIATION_COMPLETION_PARAMETERS.
O quadro de resposta de associação retornado pelo driver de miniporto depende da configuração do objeto IEEE 802.11 dot11DesiredBSSType MIB:
Se o objeto dot11DesiredBSSType MIB estiver definido como dot11_BSS_type_infrastructure, o quadro é o quadro 802.11 Association Response (se bReAssocReq for TRUE) ou o quadro de resposta de reassociação (se bReAssocReq for false) que foi recebido da AP. O driver de miniporto deve retornar um quadro 802.11 Probe Response que seja enviado ao 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 miniporto deve definir o uAssocRespOffset e membros do 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 dos últimos quadros 802.11 Beacon ou Probe Response recebidos. O driver de miniporto deve excluir o cabeçalho MAC 802.11 para esses quadros ao fazer a indicação de status NDIS_STATUS_DOT11_ASSOCIATION_COMPLETION.
Esse deslocamento é relativo ao início do buffer, que contém a estrutura de DOT11_ASSOCIATION_COMPLETION_PARAMETERS.
Nota
Se o algoritmo de autenticação usado na associação foi Wi-Fi WPA (Protected Access) 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 o uBeaconOffset e membros uBeaconSize como zero.
uBeaconSize
O comprimento do último quadro de Beacon 802.11 recebido. 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 de status NDIS_STATUS_DOT11_ASSOCIATION_COMPLETION.
Esse deslocamento é relativo ao início do buffer, que contém a estrutura de DOT11_ASSOCIATION_COMPLETION_PARAMETERS.
Se o driver de miniporto não estiver retornando dados IHV na indicação de status NDIS_STATUS_DOT11_ASSOCIATION_COMPLETION, 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 nesta 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 do AuthAlgo, consulte DOT11_AUTH_ALGORITHM.
O driver de miniporto deve definir esse membro como zero se uStatus não estiver definido como DOT11_ASSOCIATION_STATUS_SUCCESS.
UnicastCipher
O algoritmo de criptografia 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 do UnicastCipher, consulte DOT11_CIPHER_ALGORITHM.
O driver de miniporto 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 do, consulte DOT11_CIPHER_ALGORITHM
O driver de miniporto 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 da Estação Extensível (ExtSTA) msDot11ActivePhyList também faz referência à lista de PHY ativo.
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 pela msDot11DesiredPhyList objeto 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 msDot11ActivePhyList MIB especificar todas as IDs 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 miniporto deve definir o uActivePhyListOffset e membros do 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 tenha sido associada a uma AP que dá suporte a serviços do sistema de distribuição (DS) para pontes 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 miniporto deve definir o membro bFourAddressSupported para FALSE se qualquer um dos seguintes forem verdadeiros:
- O objeto MIB do IEEE 802.11 dot11DesiredBSSType está definido como dot11_BSS_type_independent.
- A estação 802.11 não 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 do uStatus não está definido como DOT11_ASSOCIATION_STATUS_SUCCESS.
bPortAuthorized
Um valor booliano que, se definido como VERDADEIRO, 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 miniporto deve definir bPortAuthorized para FALSE se qualquer uma das seguintes opções for verdadeira:
- A estação 802.11 não executa autorização de porta.
- O membro do uStatus não está definido como DOT11_ASSOCIATION_STATUS_SUCCESS.
Para obter mais informações sobre autorização de porta, consulte Port-Basedde Acesso à Rede.
ucActiveQoSProtocol
Um sinalizador que especifica o protocolo QoS (qualidade do serviço) que está ativo atualmente 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 miniporto não pode determinar se o DS foi alterado após a operação de associação.
Nota
O driver de miniporto deve definir DSInfo para DOT11_DS_UNKNOWN se o objeto MIB dot11DesiredBSSType estiver definido como dot11_BSS_type_independent.
uEncapTableOffset
O deslocamento da lista de encapsulamentos IEEE EtherType para a associação BSS.
Esse deslocamento é relativo ao início do buffer, que contém a estrutura de DOT11_ASSOCIATION_COMPLETION_PARAMETERS. O valor de uEncapTableOffset deve ser alinhado em um limite de 4 bytes.
O driver de miniporto formata cada entrada nesta lista como uma estrutura DOT11_ENCAP_ENTRY.
Para obter mais informações sobre a lista de encapsulamento EtherType, consulte 802.11 Payload Encapsulation.
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 da associação solicitado pela AP (ponto de acesso). 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ões 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.
Observações
O driver de miniporto deve definir o uEncapTableOffset e membros de uEncapTableSize como zero se qualquer um dos seguintes forem verdadeiros:
- A associação BSS não requer alterações na lista padrão de encapsulamentos EtherType do sistema operacional.
- O membro do uStatus não está definido como DOT11_ASSOCIATION_STATUS_SUCCESS.
- O objeto de Base Extensível (ExtSTA) objeto dot11DesiredBSSType base de informações de gerenciamento (MIB) está definido como dot11_BSS_type_independent.
Para obter mais informações sobre o objeto MIB do IEEE 802.11 dot11DesiredBSSType, 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 AP (ponto de acesso) e o STA definem o campo MFPC (Management Frame Protection Capable) como 1 em seus respectivos IEs RSN durante o (re)procedimento de associação (ou seja, Resposta de beacon ou 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 4-way 802.11i).
Requisitos
| Requisito | Valor |
|---|---|
| de cliente com suporte mínimo | Disponível no Windows 8 e versões posteriores dos sistemas operacionais Windows. |
| cabeçalho | windot11.h (inclua Ndis.h) |