Share via

DOT11_TKIPMIC_FAILURE_PARAMETERS (Compact 2013)

  • Article

3/26/2014

This structure is used by the NDIS_STATUS_DOT11_TKIPMIC_FAILURE indication when a received packet, successfully decrypted by the TKIP cipher algorithm, fails the message integrity code (MIC) verification.

Syntax

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;

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

    DOT11_TKIPMIC_FAILURE_PARAMETERS_REVISION_1

    Size

    This member must be set to sizeof(DOT11_TKIPMIC_FAILURE_PARAMETERS)

  • 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.

Requirements

Header

windot11.h

See Also

Reference

Native 802.11 Data Types
NDIS_STATUS_DOT11_TKIPMIC_FAILURE
NDIS_OBJECT_HEADER
OID_DOT11_CIPHER_DEFAULT_KEY
OID_DOT11_CIPHER_KEY_MAPPING_KEY
Native 802.11 Wireless LAN Reference