estrutura DOT11_STATISTICS (windot11.h)

  • Artigo
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 DOT11_STATISTICS registra contadores estatísticos para a interface 802.11.

Sintaxe

typedef struct DOT11_STATISTICS {
  NDIS_OBJECT_HEADER         Header;
  ULONGLONG                  ullFourWayHandshakeFailures;
  ULONGLONG                  ullTKIPCounterMeasuresInvoked;
  ULONGLONG                  ullReserved;
  DOT11_MAC_FRAME_STATISTICS MacUcastCounters;
  DOT11_MAC_FRAME_STATISTICS MacMcastCounters;
  DOT11_PHY_FRAME_STATISTICS PhyCounters[1];
} DOT11_STATISTICS, *PDOT11_STATISTICS;

Membros

Header

O tipo, a revisão e o tamanho da estrutura DOT11_STATISTICS. Esse membro é formatado como uma estrutura NDIS_OBJECT_HEADER .

O driver de miniporte deve definir os membros de Cabeçalho para os seguintes valores:

Tipo

Esse membro deve ser definido como NDIS_OBJECT_TYPE_DEFAULT.

Revisão

Esse membro deve ser definido como DOT11_STATISTICS_REVISION_1.

Tamanho

Esse membro deve ser definido como sizeof(DOT11_STATISTICS).

Para obter mais informações sobre esses membros, consulte NDIS_OBJECT_HEADER.

ullFourWayHandshakeFailures

O número de falhas de handshake de quatro vias que a estação 802.11 encontrou durante Wi-Fi autenticação WPA (Acesso Protegido) ou RSNA (Robust Security Network Association).

Se a estação 802.11 não estiver executando a autenticação WPA ou RSNA, ela deverá definir esse membro como DOT11_STATISTICS_UNKNOWN.

ullTKIPCounterMeasuresInvoked

O número de vezes que a estação 802.11 invocou contramedidas após uma falha de MIC (código de integridade de mensagem).

Se a estação 802.11 não estiver executando contramedidas TKIP, ela deverá definir esse membro como DOT11_STATISTICS_UNKNOWN.

ullReserved

Esse membro é reservado para uso pelo sistema operacional. O driver de miniporte não deve gravar neste membro.

MacUcastCounters

Os contadores de camada MAC com base em pacotes unicast enviados ou recebidos pela estação 802.11. A estrutura de dados desse membro é a DOT11_MAC_FRAME_STATISTICS estrutura.

Observação  

Os contadores para pacotes unicast recebidos só devem ser incrementados para esses pacotes com um endereço MAC de destino no cabeçalho MAC 802.11 que corresponde ao endereço MAC da estação 802.11.

MacMcastCounters

Os contadores de camada MAC com base em pacotes de transmissão ou multicast enviados ou recebidos pela estação 802.11. A estrutura de dados desse membro é a DOT11_MAC_FRAME_STATISTICS estrutura.

Observação  

Os contadores para pacotes de transmissão ou multicast recebidos só devem ser incrementados para esses pacotes com um endereço MAC de destino no cabeçalho MAC 802.11 que corresponde a uma entrada na lista de endereços multicast da estação 802.11. Para obter mais informações sobre a lista de endereços multicast, consulte OID_DOT11_MULTICAST_LIST.

PhyCounters[1]

Uma matriz de contadores de camada PHY. Cada entrada nessa matriz é formatada como um DOT11_PHY_FRAME_STATISTICS estrutura.

O driver de miniporto deve manter uma entrada dentro da matriz PhyCounters para cada PHY com suporte. Se a estação 802.11 der suporte a vários PHYs do mesmo tipo, o driver de miniporto deverá criar entradas separadas para cada um.

As entradas na matriz PhyCounters devem estar na mesma ordem que a lista de PHYs com suporte que o driver retorna quando consultado por OID_DOT11_SUPPORTED_PHY_TYPES.

Comentários

O driver de miniporte deve definir incondicionalmente todos os contadores na estrutura DOT11_STATISTICS como zero, incluindo contadores de camada MAC e camada PHY, quando ocorre um dos seguintes procedimentos:

Para obter mais informações sobre as estatísticas coletadas por um driver de miniporto Nativo 802.11, consulte Estatísticas do Native 802.11.

Requisitos

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

Confira também

OID_DOT11_STATISTICS