estrutura DOT11_PHY_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_PHY_FRAME_STATISTICS registra contadores estatísticos para a camada física IEEE (PHY) da estação 802.11.
Sintaxe
typedef struct DOT11_PHY_FRAME_STATISTICS {
ULONGLONG ullTransmittedFrameCount;
ULONGLONG ullMulticastTransmittedFrameCount;
ULONGLONG ullFailedCount;
ULONGLONG ullRetryCount;
ULONGLONG ullMultipleRetryCount;
ULONGLONG ullMaxTXLifetimeExceededCount;
ULONGLONG ullTransmittedFragmentCount;
ULONGLONG ullRTSSuccessCount;
ULONGLONG ullRTSFailureCount;
ULONGLONG ullACKFailureCount;
ULONGLONG ullReceivedFrameCount;
ULONGLONG ullMulticastReceivedFrameCount;
ULONGLONG ullPromiscuousReceivedFrameCount;
ULONGLONG ullMaxRXLifetimeExceededCount;
ULONGLONG ullFrameDuplicateCount;
ULONGLONG ullReceivedFragmentCount;
ULONGLONG ullPromiscuousReceivedFragmentCount;
ULONGLONG ullFCSErrorCount;
} DOT11_PHY_FRAME_STATISTICS, *PDOT11_PHY_FRAME_STATISTICS;
Membros
ullTransmittedFrameCount
O número de pacotes MSDU e quadros MMPDU que a camada IEEE PHY da estação 802.11 transmitiu com êxito.
ullMulticastTransmittedFrameCount
O número de pacotes MSDU multicast ou de transmissão e quadros MMPDU que a camada PHY do IEEE da estação 802.11 transmitiu com êxito.
ullFailedCount
O número de pacotes MSDU e quadros MMPDU que a estação 802.11 não transmitiu depois de exceder os limites de repetição definidos pelos contadores IEEE dot11ShortRetryLimit ou dot11LongRetryLimit contadores MIB. Para obter mais informações sobre esses contadores MIB, consulte OID_DOT11_SHORT_RETRY_LIMIT ou OID_DOT11_LONG_RETRY_LIMIT.
ullRetryCount
O número de pacotes MSDU e quadros MMPDU que a estação 802.11 transmitiu com êxito após uma ou mais tentativas.
ullMultipleRetryCount
O número de pacotes MSDU e quadros MMPDU que a estação 802.11 transmitiu com êxito após mais de uma tentativa de retransmissão.
Para pacotes MSDU, o driver de miniporto deve incrementar esse contador para cada pacote que foi transmitido com êxito após um ou mais fragmentos de MPDU exigirem retransmissão.
ullMaxTXLifetimeExceededCount
O número de pacotes MSDU e quadros MMPDU que a estação 802.11 não transmitiu devido a um tempo limite definido pelo objeto IEEE 802.11 dot11MaxTransmitMSDULifetime objeto MIB. Para obter mais informações sobre esse objeto MIB, consulte OID_DOT11_MAX_TRANSMIT_MSDU_LIFETIME.
ullTransmittedFragmentCount
O número de quadros MPDU que a estação 802.11 transmitiu e reconheceu por meio de um quadro ACK 802.11 recebido.
ullRTSSuccessCount
O número de vezes que a estação 802.11 recebeu um quadro Desmarcado para Enviar (CTS) em resposta a um quadro RTS (Solicitação de Envio).
ullRTSFailureCount
O número de vezes que a estação 802.11 não recebeu um quadro CTS em resposta a um quadro RTS.
ullACKFailureCount
O número de vezes que a estação 802.11 esperava e não recebeu um quadro de Confirmação (ACK).
ullReceivedFrameCount
O número total de pacotes MSDU e quadros MMPDU que a estação 802.11 recebeu com êxito.
Para pacotes MSDU, o driver de miniporto deve incrementar esse contador para cada pacote cujos fragmentos de MPDU foram recebidos e a verificação de fcs (sequência de verificação de quadros) passada e detecção de repetição. O driver de miniporto deve incrementar esse membro independentemente de o pacote MSDU recebido ou o fragmento MPDU falhar na descriptografia da criptografia da camada MAC.
Esse contador é opcional. Se a NIC não der suporte a esse contador, o driver de miniporto deverá definir esse membro como DOT11_STATISTICS_UNKNOWN.
ullMulticastReceivedFrameCount
O número de pacotes MSDU multicast ou de transmissão e quadros MMPDU que a estação 802.11 recebeu com êxito.
Para pacotes MSDU, o driver de miniporto deve incrementar esse contador para cada pacote cujos fragmentos de MPDU foram recebidos e passou pela verificação e detecção de reprodução do FCS. O driver de miniporto deve incrementar esse membro independentemente de o pacote MSDU recebido ou o fragmento MPDU falhar na descriptografia da criptografia da camada MAC.
Esse contador é opcional. Se a NIC não der suporte a esse contador, o driver de miniporto deverá definir esse membro como DOT11_STATISTICS_UNKNOWN.
ullPromiscuousReceivedFrameCount
O número de pacotes MSDU ou quadros MMPDU recebidos pela estação 802.11 quando um filtro de pacote promíscuo é habilitado. Para obter mais informações sobre filtros de pacote, consulte OID_GEN_CURRENT_PACKET_FILTER.
Se um filtro de pacote promíscuo estiver habilitado, o driver de miniporto só deverá incrementar esse contador para pacotes MSDU recebidos ou quadros MMPDU que teriam sido rejeitados se o filtro não estivesse habilitado. O driver não deve incrementar este contador para:
- Pacotes MSDU unicast ou quadros MMPDU com um endereço MAC de destino que corresponde ao endereço MAC da estação 802.11.
- Pacotes MSDU de transmissão multicast ou quadros MMPDU com um endereço MAC de destino 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.
ullMaxRXLifetimeExceededCount
O número se pacotes MSDU e quadros MMPDU que a estação 802.11 descartou devido a um tempo limite, conforme definido pelo objeto IEEE 802.11 dot11MaxReceiveLifetime MIB. Para obter mais informações sobre esse objeto MIB, consulte OID_DOT11_MAX_RECEIVE_LIFETIME.
ullFrameDuplicateCount
O número de quadros MPDU duplicados que a estação 802.11 recebeu. A estação 802.11 determina quadros duplicados por meio do campo Controle de Sequência do cabeçalho MAC 802.11.
ullReceivedFragmentCount
O número de quadros MPDU recebidos pela estação 802.11 para pacotes MSDU ou quadros MMPDU.
ullPromiscuousReceivedFragmentCount
O número de quadros MPDU recebidos pela estação 802.11 para pacotes MSDU ou quadros MMPDU quando um filtro de pacote promíscuo foi habilitado. Para obter mais informações sobre filtros de pacote, consulte OID_GEN_CURRENT_PACKET_FILTER.
Se um filtro de pacote promíscuo estiver habilitado, o driver de miniporto só deverá incrementar esse contador para quadros MPDU recebidos que teriam sido rejeitados se o filtro não estivesse habilitado. O driver não deve incrementar este contador para:
- Quadros DE MPDU unicast com um endereço MAC de destino que corresponde ao endereço MAC da estação 802.11.
- Quadros MPDU de transmissão ou multicast com um endereço MAC de destino 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.
ullFCSErrorCount
O número de quadros MPDU que a estação 802.11 recebeu com erros de FCS.
Observações
Os membros dessa estrutura são usados para registrar estatísticas de nível PHY 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) |