OID_802_11_STATISTICS

When queried, the OID_802_11_STATISTICS OID requests that the miniport driver return the current statistics for the IEEE 802.11 interface.

This OID is not mandatory, but it is recommended. If the miniport driver does not support this OID, the driver returns NDIS_STATUS_NOT_SUPPORTED.

These statistics are described by an NDIS_802_11_STATISTICS structure, which is defined as follows:

    typedef struct _NDIS_802_11_STATISTICS {
         ULONG Length;
         LARGE_INTEGER TransmittedFragmentCount;

         LARGE_INTEGER MulticastTransmittedFrameCount;
         LARGE_INTEGER FailedCount;
         LARGE_INTEGER RetryCount;
 LARGE_INTEGER
 MultipleRetryCount;         LARGE_INTEGER RTSSuccessCount;
         LARGE_INTEGER RTSFailureCount;
         LARGE_INTEGER ACKFailureCount;

         LARGE_INTEGER FrameDuplicateCount;
         LARGE_INTEGER ReceivedFragmentCount;
         LARGE_INTEGER MulticastReceivedFrameCount;

         LARGE_INTEGER FCSErrorCount;
         LARGE_INTEGER TKIPLocalMICFailures;
         LARGE_INTEGER TKIPICVErrors;
 LARGE_INTEGER
 TKIPCounterMeasuresInvoked;         LARGE_INTEGER TKIPReplays;
         LARGE_INTEGER CCMPFormatErrors;
         LARGE_INTEGER CCMPReplays;

         LARGE_INTEGER CCMPDecryptErrors;
         LARGE_INTEGER FourWayHandshakeFailures;
         LARGE_INTEGER WEPUndecryptableCount;

         LARGE_INTEGER WEPICVErrorCount;
         LARGE_INTEGER DecryptSuccessCount;
         LARGE_INTEGER DecryptFailureCount;
 
    }
 NDIS_802_11_STATISTICS, *PNDIS_802_11_STATISTICS;
  

The members of this structure contain the following information:

  • Length
    The length, in bytes, of the NDIS_802_11_STATISTICS structure.

  • TransmittedFragmentCount
    The number of data and management fragments that the NIC has successfully transmitted.

  • MulticastTransmittedFrameCount
    The number of frames that the NIC has transmitted by multicast or broadcast. This count is incremented each time that the multicast/broadcast bit is set in the destination MAC address of a transmitted frame.

  • FailedCount
    The number of NIC frame transmissions that failed after exceeding either the short frame or the long frame retry limits.

  • RetryCount
    The number of frames that the NIC successfully retransmitted after one or more retransmission attempts.

  • MultipleRetryCount
    The number of frames that the NIC successfully retransmitted after more than one retransmission attempt.

  • RTSSuccessCount
    The number of times that the NIC received a CTS in response to an RTS.

  • RTSFailureCount
    The number of times that the NIC did not receive a CTS in response to an RTS.

  • ACKFailureCount
    The number of times that the NIC expected an ACK that was not received.

  • FrameDuplicateCount
    The number of duplicate frames that the NIC received. The sequence control field in the frame identifies duplicate frames.

  • ReceivedFragmentCount
    The number of data and management fragments that the NIC has successfully received. This count is incremented each time that the NIC receives either a data fragment or a management fragment.

  • MulticastReceivedFrameCount
    The number of frames that the NIC received that were set to multicast or broadcast. This count is incremented each time the NIC receives a frame with the multicast/broadcast bit set in the destination MAC address.

  • FCSErrorCount
    The number of frames that the NIC received that contained FCS errors.

  • TKIPLocalMICFailures
    The number of Michael MIC failures that the device encountered when it was checking the integrity of packets received at this device.

  • TKIPICVErrors
    The number of encrypted packets the device failed to decrypt due to a TKIP ICV error.

  • TKIPCounterMeasuresInvoked
    The number of times the device invoked TKIP countermeasures. If the device is operating as an access point, this variable indicates the number of times countermeasures were invoked on both the local STA and any remote STA.

  • TKIPReplays
    The number of TKIP replay errors detected.

  • CCMPFormatErrors
    The number of MSDUs received with an invalid AES-CCMP format.

  • CCMPReplays
    The number of received unicast fragments that the replay mechanism has discarded.

  • CCMPDecryptErrors
    The number of received fragments that the AES-CCMP decryption algorithm has discarded.

  • FourWayHandshakeFailures
    The number of WPA or RSNA four-way handshake failures the device has encountered.

    Note   Since the WPA or RSNA four-way handshake is performed by the 802.1x supplicant, the driver must return a 0 for this member.

     

  • WEPUndecryptableCount
    The number of encrypted packets received for which a WEP decryption key was not available on the device.

  • WEPICVErrorCount
    The number of encrypted packets the device failed to decrypt due to a WEP ICV error.

  • DecryptSuccessCount
    The number of encrypted packets successfully decrypted since the driver made a media connect indication. The driver must clear this counter whenever it makes a media connect or media disconnect indication.

    Note   The driver must not increment this counter for packets that are decrypted successfully but are discarded for other reasons. For example, the driver must not increment this counter for packets that are discarded due to TKIP MIC failures or TKIP/CCMP replays.

     

  • DecryptFailureCount
    The number of encrypted packets the device failed to decrypt since the driver made a media connect indication. The driver must clear this counter whenever it makes a media connect or media disconnect indication.

    Note   The driver increments this counter whenever it fails to decrypt a packet for which a key is available. It must not increment this counter if the packet is discarded for other reasons, such as ICV errors, TKIP MIC failures, or TKIP/CCMP replays.

     

 

 

Send comments about this topic to Microsoft