estrutura DOT11_PHY_FRAME_STATISTICS (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 DOT11_PHY_FRAME_STATISTICS registra contadores estatísticos para a camada física (PHY) do IEEE 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 difundidos 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 802.11 ou dot11LongRetryLimit 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 dot11MaxTransmitMSDDULifetime 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 através de um quadro ACK recebido 802.11.

ullRTSSuccessCount

O número de vezes que a estação 802.11 recebeu um quadro CTS (Limpar para Enviar) 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 MPDU foram recebidos e passados marcar de verificação e detecção de repetição da sequência de marcar de quadros (FCS). O driver de miniporte deve incrementar esse membro independentemente de o pacote MSDU recebido ou o fragmento MPDU falhar na descriptografia de criptografia da camada MAC.

Esse contador é opcional. Se a NIC não der suporte a esse contador, o driver de miniporte deverá definir esse membro como DOT11_STATISTICS_UNKNOWN.

ullMulticastReceivedFrameCount

O número de pacotes MSDU multicast ou difusã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 MPDU foram recebidos e passados para verificação fcs e detecção de reprodução. O driver de miniporte deve incrementar esse membro independentemente de o pacote MSDU recebido ou o fragmento MPDU falhar na descriptografia de criptografia da camada MAC.

Esse contador é opcional. Se a NIC não der suporte a esse contador, o driver de miniporte 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 está 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 miniporte 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 multicast ou difusão 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 miniporte 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 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.

Comentários

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 mpdu enviados para um pacote MSDU ou quadro MMPDU

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

Estatísticas PHY extensíveis da estação

OID_DOT11_STATISTICS

DOT11_STATISTICS

Estatísticas nativas de 802.11