estrutura DOT11_STATISTICS (windot11.h)
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.
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.
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:
- A função MiniportInitializeEx do driver é chamada.
- A função MiniportOidRequest do driver é chamada com uma solicitação de conjunto de OID de OID_DOT11_RESET_REQUEST, independentemente do tipo de operação de redefinição especificado na solicitação definida.
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) |