NDIS_STATUS_DOT11_DISASSOCIATION

  • Article

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 must make an NDIS_STATUS_DOT11_DISASSOCIATION indication if the 802.11 station performs a disassociation operation with either an access point (AP) (for infrastructure BSS networks) or peer station (for independent BSS (IBSS) networks). For more information about disassociation operations, see Disassociation Operations.

The data type for this indication is the DOT11_DISASSOCIATION_PARAMETERS structure.

The miniport driver calls NdisMIndicateStatusEx to make an NDIS_STATUS_DOT11_DISASSOCIATION 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_DISASSOCIATION.

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

  • StatusBufferSize must be set to sizeof(DOT11_DISASSOCIATION_PARAMETERS).

The miniport driver can make the NDIS_STATUS_DOT11_DISASSOCIATION indication only after it has completed an association operation with an AP or peer station that is identified by the MacAddr member. The miniport driver indicates the completion of an association operation through the NDIS_STATUS_DOT11_ASSOCIATION_COMPLETION indication. For more information about the association operation, see Association Operations.

After the miniport driver makes the NDIS_STATUS_DOT11_DISASSOCIATION indication and if the IEEE 802.11 dot11DesiredBssType MIB object is set to dot11_BSS_type_infrastucture, the 802.11 station must do the following:

  • If the uReason member was set to DOT11_DISASSOC_REASON_OS, the 802.11 station must not attempt to roam or associate with any AP in the BSS. The miniport driver must transition to the ExtSTA INIT operation mode. The 802.11 station must also wait until the next set request of OID_DOT11_CONNECT_REQUEST before attempting an association operation.

  • If the uReason member was not set to DOT11_DISASSOC_REASON_OS, the 802.11 station must attempt to roam to other APs within the basic service set (BSS) that the station was previously associated with.

    For more information about the roaming operation, see Roaming Operations.

For more information about the dot11DesiredBssType MIB object, see OID_DOT11_DESIRED_BSS_TYPE.

Requirements

Version

Available in Windows Vista and later versions of the Windows operating systemss.

Header

 Windot11.h (include Ndis.h)