estrutura DOT11_MAC_FRAME_STATISTICS (windot11.h)
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 DOT11_MAC_FRAME_STATISTICS registra contadores estatísticos para a subcamada mac (controle de acesso de mídia) IEEE da estação 802.11.
Sintaxe
typedef struct DOT11_MAC_FRAME_STATISTICS {
ULONGLONG ullTransmittedFrameCount;
ULONGLONG ullReceivedFrameCount;
ULONGLONG ullTransmittedFailureFrameCount;
ULONGLONG ullReceivedFailureFrameCount;
ULONGLONG ullWEPExcludedCount;
ULONGLONG ullTKIPLocalMICFailures;
ULONGLONG ullTKIPReplays;
ULONGLONG ullTKIPICVErrorCount;
ULONGLONG ullCCMPReplays;
ULONGLONG ullCCMPDecryptErrors;
ULONGLONG ullWEPUndecryptableCount;
ULONGLONG ullWEPICVErrorCount;
ULONGLONG ullDecryptSuccessCount;
ULONGLONG ullDecryptFailureCount;
} DOT11_MAC_FRAME_STATISTICS, *PDOT11_MAC_FRAME_STATISTICS;
Membros
ullTransmittedFrameCount
O número de pacotes msdu (unidade de dados de serviço MAC) e quadros de unidade de dados de protocolo de gerenciamento MAC (MMPDU) que a subcamada MAC IEEE da estação 802.11 transmitiu com êxito.
ullReceivedFrameCount
O número de pacotes MSDU e quadros MMPDU que a subcamada IEEE MAC da estação 802.11 recebeu com êxito. Esse membro não deve ser incrementado para pacotes recebidos que falharam na descriptografia de criptografia ou validação mic.
ullTransmittedFailureFrameCount
O número de pacotes MSDU e quadros MMPDU que a subcamada IEEE MAC da estação 802.11 não conseguiu transmitir com êxito.
ullReceivedFailureFrameCount
O número de pacotes MSDU e quadros MMPDU que a subcamada IEEE MAC da estação 802.11 não recebeu com êxito.
ullWEPExcludedCount
O número de quadros de MPDU (unidade de dados de protocolo MAC) recebidos não criptografados descartados quando o objeto IEEE 802.11 dot11ExcludeUnencrypted base de informações de gerenciamento (MIB) está habilitado. Para obter mais informações sobre esse objeto MIB, consulte OID_DOT11_EXCLUDE_UNENCRYPTED.
Os quadros MPDU são considerados não criptografados quando o subcampo Quadro Protegido do campo Controle de Quadros no cabeçalho MAC IEEE 802.11 é definido como zero.
ullTKIPLocalMICFailures
O número de pacotes MSDU recebidos que a estação 802.11 descartou devido a falhas de MIC.
ullTKIPReplays
O número de quadros MPDU recebidos que a estação 802.11 descartou devido ao procedimento de proteção de reprodução TKIP.
ullTKIPICVErrorCount
O número de quadros de MPDU criptografados que a estação 802.11 falhou ao descriptografar devido a um erro TKIP ICV.
ullCCMPReplays
O número de quadros MPDU recebidos que a estação 802.11 descartou devido ao procedimento de proteção de reprodução AES-CCMP.
ullCCMPDecryptErrors
O número de quadros MPDU recebidos que a estação 802.11 descartou devido a erros detectados pelo algoritmo de descriptografia AES-CCMP.
ullWEPUndecryptableCount
O número de quadros de MPDU criptografados recebidos para os quais uma chave de descriptografia WEP não estava disponível na estação 802.11.
ullWEPICVErrorCount
O número de quadros de MPDU criptografados que a estação 802.11 falhou ao descriptografar devido a um erro de ICV do WEP.
ullDecryptSuccessCount
O número de pacotes criptografados recebidos que a estação 802.11 descriptografou com êxito.
Para os algoritmos de criptografia WEP e TKIP, o driver de miniporto deve incrementar esse contador para cada MPDU criptografado recebido que foi descriptografado com êxito. Para o algoritmo de criptografia AES-CCMP, o driver de miniporto deve incrementar esse contador em cada pacote MSDU criptografado recebido que foi descriptografado com êxito.
ullDecryptFailureCount
O número de pacotes criptografados que a estação 802.11 não descriptografou.
Para os algoritmos de criptografia WEP e TKIP, o driver de miniporto deve incrementar esse contador para cada MPDU criptografado recebido que não foi descriptografado com êxito. Para o algoritmo de criptografia AES-CCMP, o driver de miniporto deve incrementar esse contador em cada pacote MSDU criptografado recebido que não foi descriptografado com êxito.
O driver de miniporto não deve incrementar esse contador para pacotes que são descriptografados com êxito, mas são descartados por outros motivos. Por exemplo, o driver de miniporto não deve incrementar esse contador para pacotes descartados devido a falhas de MIC TKIP ou reproduções TKIP/CCMP.
Observações
Os membros da estrutura DOT11_MAC_STATISTICS são usados para registrar estatísticas de nível MAC para:
- 802.11 pacotes MSDU.
- 802.11 quadros MMPDU.
- 802.11 quadros MPDU. Os contadores de quadro mpdu devem incluir todos os fragmentos de MPDU enviados para um pacote MSDU ou quadro MMPDU
Requisitos
| Requisito | Valor |
|---|---|
| de cliente com suporte mínimo | Disponível no Windows Vista e versões posteriores dos sistemas operacionais Windows. |
| cabeçalho | windot11.h (inclua Ndis.h) |