estrutura DOT11_PEER_INFO (windot11.h)

Importante A interface lan sem fio Native 802.11 foi preterida em Windows 10 e posteriores. Em vez disso, use a WDI (Interface do Driver de Dispositivo) WLAN. Para obter mais informações sobre o WDI, consulte WLAN Modelo de driver Universal do Windows.
 
A estrutura de DOT11_PEER_INFO especifica informações sobre uma estação par em uma rede independente do IBSS (conjunto de serviços básico).
Nota O IBSS (Ad hoc) e o SoftAP foram preteridos. Começando com Windows 8.1 e 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 recebeu mais recentemente 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 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 para o 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 WPS (Instalação Protegida por WiFi) está habilitada para a estação par. Se TRUE, o WPS estiver habilitado e os algoritmos de autenticação e codificação usados pelo par poderão ser diferentes dos algoritmos habilitados no 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 par. Essas taxas se baseiam no IE de taxas com suporte 802,11 dos quadros de resposta de sinalizador ou investigação que a estação 802.11 recebeu mais recentemente 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 de 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_STATE que indica o estado de autenticação e associação 802,11 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_MODE que 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.

Requisitos

Requisito Valor
Cliente mínimo com suporte Disponível no Windows 7 e versões posteriores dos sistemas operacionais Windows.
Cabeçalho windot11.h (inclua Ndis.h)

Confira também

DOT11_POWER_MODE

DOT11_ASSOCIATION_STATE

NdisGetCurrentSystemTime

DOT11_PEER_STATISTICS

DOT11_PEER_INFO_LIST

NDIS_OBJECT_HEADER