estrutura DOT11_PEER_INFO (windot11.h)

Artigo
02/07/2025

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 de DOT11_PEER_INFO especifica informações em uma estação par dentro de uma rede independente do IBSS (conjunto de serviços básico).

Observação IBSS (Ad hoc) e SoftAP foram preteridos. Começando com o Windows 8.1 e o Windows Server 2012 R2, use Wi-Fi Direct.

Sintaxe

typedef struct _DOT11_PEER_INFO {
  DOT11_MAC_ADDRESS       MacAddress;
  USHORT                  usCapabilityInformation;
  DOT11_AUTH_ALGORITHM    AuthAlgo;
  DOT11_CIPHER_ALGORITHM  UnicastCipherAlgo;
  DOT11_CIPHER_ALGORITHM  MulticastCipherAlgo;
  BOOLEAN                 bWpsEnabled;
  USHORT                  usListenInterval;
  UCHAR                   ucSupportedRates[MAX_NUM_SUPPORTED_RATES_V2];
  USHORT                  usAssociationID;
  DOT11_ASSOCIATION_STATE AssociationState;
  DOT11_POWER_MODE        PowerMode;
  LARGE_INTEGER           liAssociationUpTime;
  DOT11_PEER_STATISTICS   Statistics;
} DOT11_PEER_INFO, *PDOT11_PEER_INFO;

Membros

MacAddress

O endereço MAC (controle de acesso à mídia) da estação par em uma rede independente do BSS (IBSS).

usCapabilityInformation

O campo Informações de Funcionalidade 802.11 dos quadros de resposta de sinalizador ou investigação que a estação 802.11 mais recentemente recebeu do par.

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.

Esse membro não será definido se o par não estiver associado.

UnicastCipherAlgo

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 do membro UnicastCipherAlgo, consulte DOT11_CIPHER_ALGORITHM.

Esse membro não será definido se o par não estiver associado.

MulticastCipherAlgo

O algoritmo de criptografia multicast 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 MulticastCipherAlgo, consulte DOT11_CIPHER_ALGORITHM.

Esse membro não será definido se o par não estiver associado.

bWpsEnabled

Um valor booliano que indica se a Configuração Protegida por WiFi (WPS) está habilitada para a estação par. Se VERDADEIRO, o WPS está habilitado e os algoritmos de autenticação e codificação usados pelo par podem ser diferentes dos algoritmos habilitados na AP.

Esse membro não deverá ser usado se o par não estiver associado.

usListenInterval

Um valor USHORT que define o campo Intervalo de Escuta 802.11 obtido da solicitação de associação.

Esse membro terá um valor igual a zero se o par não estiver associado.

ucSupportedRates[MAX_NUM_SUPPORTED_RATES_V2]

Um valor UCHAR que especifica as taxas de dados compatíveis com a estação de pares. Essas taxas se baseiam no IE de taxas com suporte 802.11 dos quadros de resposta de baliza ou investigação que a estação 802.11 mais recentemente recebeu do par.

Cada entrada na matriz ucPeerSupportedRates é o valor de um índice dentro da tabela de taxas de dados retornada por meio de uma consulta de OID_DOT11_DATA_RATE_MAPPING_TABLE. O valor do índice deve estar entre 2 e 127.

Esse membro terá um valor igual a zero se o par não estiver associado.

usAssociationID

Um valor USHORT que especifica o campo ID da Associação 802.11 dos quadros de resposta de associação ou re-associação que a estação 802.11 recebeu da AP.

Esse membro terá um valor de 0xFFFF se o par não estiver associado.

AssociationState

Um valor de tipo DOT11_ASSOCIATION_STATEque indica a autenticação 802.11 e o estado de associação da estação par. O estado pode ser dot11_assoc_state_auth_unassoc ou dot11_assoc_state_auth_assoc.

No IEEE 802.11 Standard, o procedimento de autenticação 802.11 é opcional para uma rede independente. Portanto, dependendo da implementação de IHV, o estado representado pelo valor de enumeração dot11_assoc_state_auth_unassoc pode não ser aplicável.

PowerMode

Um valor de tipo DOT11_POWER_MODEque descreve o modo de gerenciamento de energia mais recente da estação par.

liAssociationUpTime

Um valor LARGEINTEGER que especifica o carimbo de data/hora quando o procedimento de associação 802.11 foi concluído com êxito. O driver de miniporto chama NdisGetCurrentSystemTime para obter o carimbo de data/hora da conclusão da associação.

Esse membro terá um valor igual a zero se o par não estiver associado.

Statistics

Os contadores de estatísticas para o tráfego de dados, definidos pela estrutura DOT11_PEER_STATISTICS.

Esse membro terá um valor igual a zero se o par não estiver associado.