estrutura DOT11_INCOMING_ASSOC_COMPLETION_PARAMETERS (windot11.h)
A estrutura de 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 BSS de infraestrutura.
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 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_INCOMING_ASSOC_COMPLETION_PARAMETERS_REVISION_1.
Tamanho
Esse membro deve ser definido como tamanhos de(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 não zero de uStatus, esse membro indica a origem do erro que impede a associação. A NIC deve definir ucErrorSource para um dos seguintes valores:
DOT11_ASSOC_ERROR_SOURCE_OS
O driver de miniporto 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 rejeitaram o procedimento de associação. Nesse caso, uStatus deve ser definido como o código de status 802.11 que forma o quadro de autenticação 802.11, o quadro de resposta de associação ou o quadro de resposta de re-associação. A tabela 19 no especificação IEEE 802.11-2003 contém todos os valores possíveis. O driver de miniporto 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 nova 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 de informações (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 de informações (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 de informações (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 de informações (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 do membro do AuthAlgo, consulte DOT11_AUTH_ALGORITHM.
UnicastCipher
O algoritmo de criptografia 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 do 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 do membro MulticastCipher, consulte DOT11_CIPHER_ALGORITHM.
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. Cada entrada é um valor ULONG.
A Estação Extensível (ExtSTA) objeto msDot11ActivePhyList MIB também faz referência à lista PHY ativa.
As entradas na lista PHY ativa podem ser um dos seguintes valores:
- Uma ID de PHY especificada pelo objeto MIB (Extensible Station) msDot11DesiredPhyList base de informações de gerenciamento (MIB). 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 de PHY especificadas pelo objeto msDot11DesiredPhyList MIB. Para obter mais informações sobre esse objeto MIB, consulte OID_DOT11_ACTIVE_PHY_LIST.
Observação 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 de Beacon transmitido 802.11.
O quadro beacon inclui o cabeçalho do quadro Beacon e todos os elementos de informação (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 do quadro de dados ou o status de associação do cliente, 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 de Beacon transmitido 802.11.
O quadro beacon inclui o cabeçalho do quadro Beacon e todos os elementos de informação (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 do quadro de dados ou o status de associação do cliente, como carimbo de data/hora, parâmetros de rádio, TIM, ERP e IEs de HT, não precisam ser precisos,
Observações
O driver de miniporto Nativo 802.11 inclui uma estrutura de DOT11_INCOMING_ASSOC_COMPLETION_PARAMETERS quando o driver faz um NDIS_STATUS_DOT11_INCOMING_ASSOC_COMPLETION indicação de status.
A indicação de status NDIS_STATUS_DOT11_INCOMING_ASSOC_COMPLETION 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 a indicação de NDIS_STATUS_DOT11_INCOMING_ASSOC_COMPLETION se a resposta é enviada com êxito ou não. A falha pode ocorrer 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 |
|---|---|
| de cliente com suporte mínimo | Disponível no Windows 7 e versões posteriores do sistema operacional Windows. |
| cabeçalho | windot11.h (inclua Ndis.h) |