NDIS_STATUS_DOT11_ASSOCIATION_COMPLETION (Compact 2013)

  • Article

3/26/2014

A miniport driver must make an NDIS_STATUS_DOT11_ASSOCIATION_COMPLETION indication after an association operation is complete.

The miniport driver indicates the start of the association operation through the NDIS_STATUS_DOT11_ASSOCIATION_START indication. Every NDIS_STATUS_DOT11_ASSOCIATION_START indication made by the driver must have a corresponding NDIS_STATUS_DOT11_ASSOCIATION_COMPLETION indication.

The data type for this indication is the DOT11_ASSOCIATION_COMPLETION_PARAMETERS structure.

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

  • StatusCode must be set to NDIS_STATUS_DOT11_ASSOCIATION_COMPLETION
  • StatusBuffer must be set to the address of a DOT11_ASSOCIATION_COMPLETION_PARAMETERS structure
  • StatusBufferSize must be set to sizeof(DOT11_ASSOCIATION_COMPLETION_PARAMETERS)

After the miniport driver makes the NDIS_STATUS_DOT11_ASSOCIATION_COMPLETION indication with the uStatus member set to DOT11_ASSOCIATION_STATUS_SUCCESS, the miniport driver must do the following:

  • Be prepared to send and receive packets. If the 802.11 station performed the association operation within the context of either a connection or roaming operation, the miniport driver must be able to send or receive packets before it makes the NDIS_STATUS_DOT11_CONNECTION_COMPLETION or NDIS_STATUS_DOT11_ROAMING_COMPLETION indications.
  • Add an entry for the current association into its association information list. If the IEEE 802.11 dot11DesiredBSSType MIB object is set to dot11_BSS_type_infrastructure, the miniport driver must remove the entry for the previous association from its association information list.
    For more information about the association information list, see OID_DOT11_ENUM_ASSOCIATION_INFO.
  • Initialize the authentication algorithm that is specified by the AuthAlgo member, and cipher algorithms. This are specified by the UnicastCipher and MulticastCipher members, for the association.
  • Delete all non-static default cipher keys. Non-static default cipher keys are created by using the bStatic member of the DOT11_CIPHER_DEFAULT_KEY_VALUE structure set to FALSE. For more information about this structure, see OID_DOT11_CIPHER_DEFAULT_KEY.
  • Delete any non-static key-mapping keys for the AP or peer station identified by the MacAddr member. Non-static key-mapping keys are created by using the bStatic member of the DOT11_CIPHER_KEY_MAPPING_KEY_VALUE structure set to FALSE. For more information about this structure, see OID_DOT11_CIPHER_KEY_MAPPING_KEY.

For more information about the IEEE 802.11 dot11DesiredBSSType MIB object, see OID_DOT11_DESIRED_BSS_TYPE.

See Also

Reference

Native 802.11 Extensible Station Status Indications
NDIS_STATUS_DOT11_ASSOCIATION_START
DOT11_ASSOCIATION_COMPLETION_PARAMETERS
NdisMIndicateStatusEx
NDIS_STATUS_INDICATION
NDIS_STATUS_DOT11_CONNECTION_COMPLETION
NDIS_STATUS_DOT11_ROAMING_COMPLETION
OID_DOT11_ENUM_ASSOCIATION_INFO
DOT11_CIPHER_DEFAULT_KEY_VALUE
OID_DOT11_CIPHER_DEFAULT_KEY
DOT11_CIPHER_KEY_MAPPING_KEY_VALUE
OID_DOT11_CIPHER_KEY_MAPPING_KEY
OID_DOT11_DESIRED_BSS_TYPE
Native 802.11 Wireless LAN Status Indications