estrutura DOT11_INCOMING_ASSOC_COMPLETION_PARAMETERS (windot11.h)
A estrutura DOT11_INCOMING_ASSOC_COMPLETION_PARAMETERS especifica os resultados da operação de associação executada pela estação 802.11 depois de receber uma solicitação de associação de uma estação par em uma infraestrutura BSS.
Sintaxe
typedef struct _DOT11_INCOMING_ASSOC_COMPLETION_PARAMETERS {
NDIS_OBJECT_HEADER Header;
DOT11_MAC_ADDRESS PeerMacAddr;
ULONG uStatus;
UCHAR ucErrorSource;
BOOLEAN bReAssocReq;
BOOLEAN bReAssocResp;
ULONG uAssocReqOffset;
ULONG uAssocReqSize;
ULONG uAssocRespOffset;
ULONG uAssocRespSize;
DOT11_AUTH_ALGORITHM AuthAlgo;
DOT11_CIPHER_ALGORITHM UnicastCipher;
DOT11_CIPHER_ALGORITHM MulticastCipher;
ULONG uActivePhyListOffset;
ULONG uActivePhyListSize;
ULONG uBeaconOffset;
ULONG uBeaconSize;
} DOT11_INCOMING_ASSOC_COMPLETION_PARAMETERS, *PDOT11_INCOMING_ASSOC_COMPLETION_PARAMETERS;
Membros
Header
O tipo, a revisão e o tamanho da estrutura DOT11_INCOMING_ASSOC_COMPLETION_PARAMETERS. Esse membro é formatado como uma estrutura NDIS_OBJECT_HEADER .
O driver de miniporta deve definir os membros de 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_INCOMING_ASSOC_COMPLETION_PARAMETERS_REVISION_1.
Tamanho
Esse membro deve ser definido como sizeof(DOT11_INCOMING_ASSOC_COMPLETION_PARAMETERS).
Para obter mais informações sobre esses membros, consulte NDIS_OBJECT_HEADER.
PeerMacAddr
O endereço MAC (controle de acesso à mídia) da estação par que enviou uma solicitação de associação.
uStatus
O status da associação com a estação par. Se zero, a associação terá êxito. Se não for zero, a associação falhará.
ucErrorSource
Para valores diferentes de zero de uStatus, esse membro indica a origem do erro que impede a associação. A NIC deve definir ucErrorSource como um dos seguintes valores:
DOT11_ASSOC_ERROR_SOURCE_OS
O driver de miniporta rejeitou o procedimento de associação devido a erros do sistema, como erros de memória insuficiente. Nesse caso, uStatus deve ser definido como o código NDIS_STATUS_XXX ou NTSTATUS_XXX retornado do sistema operacional.
DOT11_ASSOC_ERROR_SOURCE_REMOTE
A AP ou a estação par rejeitou o procedimento de associação. Nesse caso, uStatus deve ser definido como o código 802.11 status forma o quadro de autenticação 802.11, quadro de resposta de associação ou quadro de resposta de associação novamente. A Tabela 19 na Especificação IEEE 802.11-2003 contém todos os valores possíveis. O driver de miniporta também pode retornar novos valores nesta especificação IEEE quando ele é alterado.
DOT11_ASSOC_ERROR_SOURCE_OTHER
A associação falhou por um motivo específico do IHV. Nesse caso, uStatus contém um valor diferente de zero especificado pelo IHV.
bReAssocReq
Um valor booliano que indica se a solicitação da estação par é uma solicitação de re-associação.
bReAssocResp
Um valor booliano que indica se a resposta da NIC é uma solicitação de nova associação.
uAssocReqOffset
O deslocamento do quadro de solicitação usado na operação de associação. O quadro inclui elementos informativos (IEs), mas não inclui o cabeçalho MAC 802.11.
uAssocReqSize
O comprimento, em bytes, do quadro de solicitação usado na operação de associação. O quadro inclui elementos informativos (IEs), mas não inclui o cabeçalho MAC 802.11.
uAssocRespOffset
O deslocamento do quadro de resposta usado na operação de associação. O quadro inclui elementos informativos (IEs), mas não inclui o cabeçalho MAC 802.11.
uAssocRespSize
O comprimento do quadro de resposta, em bytes, usado na operação de associação. O quadro inclui elementos informativos (IEs), mas não inclui o cabeçalho MAC 802.11.
AuthAlgo
O algoritmo de autenticação que a estação 802.11 resolveu com a estação par durante a operação de associação. Para obter mais informações sobre o tipo de dados para o membro AuthAlgo , consulte DOT11_AUTH_ALGORITHM.
UnicastCipher
O algoritmo de codificação unicast que a estação 802.11 resolveu com 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.
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.
uActivePhyListOffset
O deslocamento da lista de identificadores PHY (IDs) que a estação 802.11 usa para enviar ou receber pacotes na conexão de rede BSS. Cada entrada é um valor ULONG.
O objeto MIB da Estação Extensível (ExtSTA) msDot11ActivePhyList também faz referência à lista PHY ativa.
As entradas na lista PHY ativa podem ser um dos seguintes valores:
- Uma ID PHY especificada pelo objeto de base de informações de gerenciamento (MIB) da Estação Extensível (ExtSTA) msDot11DesiredPhyList . Para obter mais informações sobre esse objeto MIB, consulte OID_DOT11_DESIRED_PHY_LIST.
-
Uma ID de PHY de DOT11_PHY_ID_ANY. O driver de miniporto poderá definir uma entrada para esse valor se o objeto ExtSTA msDot11ActivePhyList MIB especificar todas as IDs PHY especificadas pelo objeto MIB msDot11DesiredPhyList . Para obter mais informações sobre esse objeto MIB, consulte OID_DOT11_ACTIVE_PHY_LIST.
Nota Uma entrada com o valor de DOT11_PHY_ID_ANY deve ser a única entrada na lista PHY ativa.
uActivePhyListSize
O comprimento, em bytes, da lista PHY ativa. O membro uActivePhyListSize deve ser um múltiplo de sizeof(ULONG).
uBeaconOffset
O deslocamento, em bytes, do último quadro beacon transmitido 802.11.
O quadro Beacon inclui o cabeçalho do quadro Beacon e todos os elementos de informações (IEs), mas não inclui o cabeçalho MAC 802.11. O formato de quadro beacon é definido em ISO/IEC 8802-11.
O quadro beacon deve ser o quadro mais recente usado pelo driver, exceto que os parâmetros em tempo real ou IEs que variam com o controle de fluxo de quadro de dados ou a associação do cliente status como carimbo de data/hora, parâmetros de rádio, TIM, ERP e IEs de HT, não precisam ser precisos,
uBeaconSize
O comprimento, em bytes, do último quadro beacon transmitido 802.11.
O quadro Beacon inclui o cabeçalho do quadro Beacon e todos os elementos de informações (IEs), mas não inclui o cabeçalho MAC 802.11. O formato de quadro beacon é definido em ISO/IEC 8802-11.
O quadro beacon deve ser o quadro mais recente usado pelo driver, exceto que os parâmetros em tempo real ou IEs que variam com o controle de fluxo de quadro de dados ou a associação do cliente status como carimbo de data/hora, parâmetros de rádio, TIM, ERP e IEs de HT, não precisam ser precisos,
Comentários
O driver de miniporto Native 802.11 inclui uma estrutura DOT11_INCOMING_ASSOC_COMPLETION_PARAMETERS quando o driver faz um NDIS_STATUS_DOT11_INCOMING_ASSOC_COMPLETION indicação status.
A indicação NDIS_STATUS_DOT11_INCOMING_ASSOC_COMPLETION status marca o fim de um bloco de indicação de associação. Se a associação for bem-sucedida, a NIC deverá fazer a indicação de NDIS_STATUS_DOT11_INCOMING_ASSOC_COMPLETION depois de enviar com êxito o quadro de resposta de associação correspondente para a estação que solicitou originalmente a associação. Se a associação falhar, a NIC deverá fazer o NDIS_STATUS_DOT11_INCOMING_ASSOC_COMPLETION indica se a resposta foi enviada com êxito ou não. A falha pode ser porque a NIC ou o sistema operacional rejeitam a solicitação de associação ou devido a uma falha não relacionada à estrutura 802.11.
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte | Disponível no Windows 7 e versões posteriores do sistema operacional Windows. |
| Cabeçalho | windot11.h (inclua Ndis.h) |