NDIS_STATUS_DOT11_TKIPMIC_FAILURE

Important  The Native 802.11 Wireless LAN interface is deprecated in Windows 10 and later. Please use the WLAN Device Driver Interface (WDI) instead. For more information about WDI, see WLAN Universal Windows driver model.

A miniport driver uses the NDIS_STATUS_DOT11_TKIPMIC_FAILURE indication whenever a received packet, successfully decrypted by the TKIP cipher algorithm, fails the message integrity code (MIC) verification.

The data type for this indication is the DOT11_TKIPMIC_FAILURE_PARAMETERS structure:

    typedef struct DOT11_TKIPMIC_FAILURE_PARAMETERS {
         NDIS_OBJECT_HEADER Header;
         BOOLEAN bDefaultKeyFailure;
         ULONG uKeyIndex;
         DOT11_MAC_ADDRESS PeerMac;
    } DOT11_TKIPMIC_FAILURE_PARAMETERS,   *PDOT11_TKIPMIC_FAILURE_PARAMETERS;
  

The DOT11_TKIPMIC_FAILURE_PARAMETERS structure contains the following members:

Header
The type, revision, and size of the DOT11_TKIPMIC_FAILURE_PARAMETERS structure. This member is formatted as an NDIS_OBJECT_HEADER structure.

The miniport driver must set the members of Header to the following values:

Type
This member must be set to NDIS_OBJECT_TYPE_DEFAULT.

Revision
This member must be set to DOT11_TKIPMIC_FAILURE_PARAMETERS_REVISION_1.

Size
This member must be set to sizeof(DOT11_TKIPMIC_FAILURE_PARAMETERS).

For more information about these members, see NDIS_OBJECT_HEADER.

bDefaultKeyFailure
A Boolean value that indicates which cipher key type detected the TKIP-MIC failure occurred. If TRUE, the TKIP-MIC failure was detected through a default cipher key. For more information about default cipher keys, see OID_DOT11_CIPHER_DEFAULT_KEY.

If FALSE, the TKIP-MIC failure was detected through a key mapping cipher key. For more information about key mapping cipher keys, see OID_DOT11_CIPHER_KEY_MAPPING_KEY.

uKeyIndex
The index of the cipher key in the default key array. The value of uKeyIndex must be from 0 through 3.

The uKeyIndex member is valid only if the bDefaultKeyFailure member is TRUE. The miniport driver must set uKeyIndex to zero if bDefaultKeyFailure is FALSE.

PeerMac
The media access control (MAC) address of the access point (AP) (for infrastructure BSS networks) or peer station (for independent BSS (IBSS) networks) that transmitted the packet that failed MIC verification. If the NIC is in Extensible Access Point (ExtAP) mode, this member contains the MAC address of the associated peer station that transmitted the packet that failed MIC verification.

The miniport driver calls NdisMIndicateStatusEx to make an NDIS_STATUS_DOT11_TKIPMIC_FAILURE indication, and must pass a pointer to an NDIS_STATUS_INDICATION structure through the StatusIndication parameter. When making this indication, the driver must set the following members of the NDIS_STATUS_INDICATION structure:

• StatusCode must be set to NDIS_STATUS_DOT11_TKIPMIC_FAILURE.

• StatusBuffer must be set to the address of a DOT11_TKIPMIC_FAILURE_PARAMETERS structure.

• StatusBufferSize must be set to sizeof(DOT11_TKIPMIC_FAILURE_PARAMETERS).

The operating system will consume this indication and determine whether and how TKIP countermeasures are invoked.

Requirements