Compartir a través de


estructura DOT11_PHY_FRAME_STATISTICS (windot11.h)

Importante

WiFiCx es el nuevo modelo de controlador de Wi-Fi lanzado en Windows 11. Se recomienda usar WiFiCx para aprovechar las características más recientes. El modelo de controlador WDI ahora está en modo de mantenimiento y solo recibirá correcciones de prioridad alta.

La estructura DOT11_PHY_FRAME_STATISTICS registra contadores estadísticos para la capa física IEEE (PHY) de la estación 802.11.

Sintaxis

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;

Miembros

ullTransmittedFrameCount

Número de paquetes MSDU y marcos MMPDU que la capa IEEE PHY de la estación 802.11 ha transmitido correctamente.

ullMulticastTransmittedFrameCount

Número de paquetes MSDU de multidifusión o difusión y fotogramas MMPDU que la capa IEEE PHY de la estación 802.11 ha transmitido correctamente.

ullFailedCount

El número de paquetes MSDU y fotogramas MMPDU que la estación 802.11 no pudo transmitir después de superar los límites de reintento definidos por los contadores de IEEE 802.11 IEEE dot11ShortRetryLimit o dot11LongRetryLimit contadores MIB. Para obtener más información sobre estos contadores MIB, consulte OID_DOT11_SHORT_RETRY_LIMIT o OID_DOT11_LONG_RETRY_LIMIT.

ullRetryCount

Número de paquetes MSDU y fotogramas MMPDU que la estación 802.11 transmite correctamente después de uno o varios intentos.

ullMultipleRetryCount

Número de paquetes MSDU y marcos MMPDU que la estación 802.11 transmitía correctamente después de más de un intento de retransmisión.

En el caso de los paquetes MSDU, el controlador de miniporte debe incrementar este contador para cada paquete que se transmitió correctamente después de uno o varios de sus fragmentos mpDU necesarios para la retransmisión.

ullMaxTXLifetimeExceededCount

Número de paquetes MSDU y marcos MMPDU que la estación 802.11 no pudo transmitir debido a un tiempo de espera definido por el objeto IEEE 802.11 dot11MaxTransmitMSDULifetime MIB. Para obtener más información sobre este objeto MIB, vea OID_DOT11_MAX_TRANSMIT_MSDU_LIFETIME.

ullTransmittedFragmentCount

Número de fotogramas MPDU que la estación 802.11 transmite y reconoce a través de un marco ACK recibido 802.11.

ullRTSSuccessCount

Número de veces que la estación 802.11 recibió un marco Clear To Send (CTS) en respuesta a un marco Request To Send (RTS).

ullRTSFailureCount

Número de veces que la estación 802.11 no recibió un fotograma CTS en respuesta a un fotograma RTS.

ullACKFailureCount

Número de veces que esperaba la estación 802.11 y no recibió un marco de confirmación (ACK).

ullReceivedFrameCount

El número total de paquetes MSDU y marcos MMPDU que la estación 802.11 ha recibido correctamente.

En el caso de los paquetes MSDU, el controlador de miniporte debe incrementar este contador para cada paquete cuyos fragmentos mpDU se recibieron y pasaron la comprobación de la secuencia de comprobación de fotogramas (FCS) y la detección de reproducción. El controlador de miniporte debe incrementar este miembro independientemente de si el paquete MSDU recibido o el fragmento MPDU producen un error en el descifrado del cifrado de capa MAC.

Este contador es opcional. Si la NIC no admite este contador, el controlador de miniport debe establecer este miembro en DOT11_STATISTICS_UNKNOWN.

ullMulticastReceivedFrameCount

Número de paquetes MSDU de multidifusión o difusión y fotogramas MMPDU que la estación 802.11 ha recibido correctamente.

En el caso de los paquetes MSDU, el controlador de minipuerto debe incrementar este contador para cada paquete cuyos fragmentos mpDU se recibieron y pasaron la comprobación de FCS y la detección de reproducción. El controlador de miniporte debe incrementar este miembro independientemente de si el paquete MSDU recibido o el fragmento MPDU producen un error en el descifrado del cifrado de capa MAC.

Este contador es opcional. Si la NIC no admite este contador, el controlador de miniport debe establecer este miembro en DOT11_STATISTICS_UNKNOWN.

ullPromiscuousReceivedFrameCount

Número de paquetes MSDU o fotogramas MMPDU recibidos por la estación 802.11 cuando se habilita un filtro de paquetes promiscuo. Para obtener más información sobre los filtros de paquetes, consulte OID_GEN_CURRENT_PACKET_FILTER.

Si se habilita un filtro de paquetes promiscuos, el controlador de miniporte solo debe incrementar este contador para los paquetes MSDU recibidos o marcos MMPDU que se habrían rechazado si el filtro no estaba habilitado. El controlador no debe incrementar este contador para:

  • Unidifusión de paquetes MSDU o marcos MMPDU con una dirección MAC de destino que coincida con la dirección MAC de la estación 802.11.
  • Multidifusión o difusión de paquetes MSDU o marcos MMPDU con una dirección MAC de destino que coincide con una entrada en la lista de direcciones de multidifusión de la estación 802.11. Para obtener más información sobre la lista de direcciones de multidifusión, vea OID_DOT11_MULTICAST_LIST.

ullMaxRXLifetimeExceededCount

Número si los paquetes MSDU y los marcos MMPDU que la estación 802.11 descarta debido a un tiempo de espera definido por el objeto IEEE 802.11 dot11MaxReceiveLifetime MIB. Para obtener más información sobre este objeto MIB, vea OID_DOT11_MAX_RECEIVE_LIFETIME.

ullFrameDuplicateCount

Número de fotogramas MPDU duplicados que recibió la estación 802.11. La estación 802.11 determina fotogramas duplicados a través del campo Control de secuencia del encabezado MAC 802.11.

ullReceivedFragmentCount

Número de fotogramas MPDU recibidos por la estación 802.11 para paquetes MSDU o marcos MMPDU.

ullPromiscuousReceivedFragmentCount

Número de fotogramas MPDU recibidos por la estación 802.11 para paquetes MSDU o marcos MMPDU cuando se ha habilitado un filtro de paquetes promiscuos. Para obtener más información sobre los filtros de paquetes, consulte OID_GEN_CURRENT_PACKET_FILTER.

Si se habilita un filtro de paquetes promiscuos, el controlador de miniporte solo debe incrementar este contador para fotogramas MPDU recibidos que se habrían rechazado si el filtro no estaba habilitado. El controlador no debe incrementar este contador para:

  • Marcos MPDU de unidifusión con una dirección MAC de destino que coincide con la dirección MAC de la estación 802.11.
  • Multidifusión o difusión de fotogramas MPDU con una dirección MAC de destino que coincide con una entrada en la lista de direcciones de multidifusión de la estación 802.11. Para obtener más información sobre la lista de direcciones de multidifusión, vea OID_DOT11_MULTICAST_LIST.

ullFCSErrorCount

Número de fotogramas MPDU que la estación 802.11 recibió con errores de FCS.

Observaciones

Los miembros de esta estructura se usan para registrar estadísticas de nivel PHY para:

  • Paquetes MSDU 802.11.
  • 802.11 marcos MMPDU.
  • 802.11 marcos MPDU. Los contadores de fotogramas MPDU deben incluir todos los fragmentos de MPDU enviados para un paquete MSDU o marco MMPDU

Requisitos

Requisito Valor
cliente mínimo admitido Disponible en Windows Vista y versiones posteriores de los sistemas operativos Windows.
encabezado de windot11.h (incluye Ndis.h)

Consulte también

estadísticas PHY de estación extensible

OID_DOT11_STATISTICS

DOT11_STATISTICS

estadísticas nativas de 802.11