Compartilhar via


estrutura DOT11_INCOMING_ASSOC_COMPLETION_PARAMETERS (windot11.h)

Importante A interface lan sem fio Native 802.11 foi preterida no Windows 10 e posterior. Em vez disso, use a WDI (Interface de Driver de Dispositivo) da WLAN. Para obter mais informações sobre o WDI, consulte Modelo de driver universal do Windows da WLAN.

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.

Nota O driver de miniporta deve definir esse membro como zero se uStatus não estiver definido como zero.

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.

Nota O driver de miniporta deve definir esse membro como zero se uStatus não estiver definido como zero.

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.

Nota O driver de miniporta deve definir esse membro como zero se uStatus não estiver definido como zero.

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.
O deslocamento da lista PHY ativa é relativo ao início do buffer que contém a estrutura DOT11_ASSOCIATION_COMPLETION_PARAMETERS.
Nota O driver de miniporta deve definir esse membro como zero se uStatus não estiver definido como zero.

uActivePhyListSize

O comprimento, em bytes, da lista PHY ativa. O membro uActivePhyListSize deve ser um múltiplo de sizeof(ULONG).

Nota O driver de miniporta deve definir esse membro como zero se uStatus não estiver definido como zero.

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,

Nota O driver de miniporta deve definir esse membro como zero se uStatus não estiver definido como zero.

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,

Nota O driver de miniporta deve definir esse membro como zero se uStatus não estiver definido como zero.

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)

Confira também

DOT11_AUTH_ALGORITHM

NDIS_STATUS_DOT11_INCOMING_ASSOC_COMPLETION

DOT11_CIPHER_ALGORITHM

NDIS_OBJECT_HEADER