DOT11_ASSOC_STATUS (Compact 2013)

3/26/2014

This data type defines a range of values that the Native 802.11 miniport driver uses to specify the results of a connection, association, disassociation or roaming network operation.

Syntax

typedef ULONG DOT11_ASSOC_STATUS;

Values

  • DOT11_ASSOC_STATUS_SUCCESS
    The network operation completed successfully
  • DOT11_ASSOC_STATUS_FAILURE
    The network operation completed with a failure

    Note

    The Native 802.11 miniport driver must specify DOT11_ASSOC_STATUS_FAILURE only if other DOT11_ASSOC_STATUS values, which are defined here, are unsuitable.

  • DOT11_ASSOC_STATUS_UNREACHABLE
    The network operation failed because the 802.11 station determined that the peer station or access point (AP) is unresponsive because of one of the following reasons:

    • The 802.11 station did not receive an 802.11 Authentication frame from the peer station or AP during the association or roaming operation
    • The 802.11 station did not receive an 802.11-Association or Reassociation Response frame from the AP during the association or roaming operation
    • The 802.11 station did not receive an 802.11 Probe Response frame from the peer station or AP after the station sent an 802.11 Probe Request frame
    • The 802.11 station no longer receives 802.11 Beacon frames from the peer station or AP
    • The 802.11 station determines the peer station or AP to be unresponsive because of other proprietary methods that are specific to the implementation by the independent hardware vendor (IHV)
  • DOT11_ASSOC_STATUS_RADIO_OFF
    The network operation failed because the radio is turned off on the 802.11 station
  • DOT11_ASSOC_STATUS_PHY_DISABLED
    The network operation failed because the PHY, which was being used for the operation, has been disabled.

    Note

    This status code is applicable only for PHYs that can be disabled on the 802.11 station through proprietary methods developed by the IHV.

  • DOT11_ASSOC_STATUS_CANCELLED
    A pending network operation failed because one of the following occurred:

  • DOT11_ASSOC_STATUS_CANDIDATE_LIST_EXHAUSTED
    A pending connection or roaming operation failed because the 802.11 station could not successfully associate with any peer station or AP from its BSS Network Candidate List
  • DOT11_ASSOC_STATUS_DISASSOCIATED_BY_OS
    If the 802.11 station is associated to a basic service set (BSS) network and is not performing a roaming operation, the Native 802.11 miniport driver uses this status code in its NDIS_STATUS_DOT11_DISASSOCIATION indication whenever one of the following OIDs is set:

    • OID_DOT11_RESET_REQUEST
    • OID_DOT11_DISCONNECT_REQUEST
  • DOT11_ASSOC_STATUS_DISASSOCIATED_BY_ROAMING
    This status code is reserved for use by the operating system for indications that it generates following an implicit disassociation operation that is performed by the Native 802.11 miniport driver.
  • DOT11_ASSOC_STATUS_DISASSOCIATED_BY_RESET
    A pending network operation failed because the Native 802.11 miniport driver failed in a call to an NDIS API.

    For example, the miniport driver would cancel the pending operation and return a status code of DOT11_ASSOC_STATUS_DISASSOCIATED_BY_RESET if the call to NdisAllocateIoWorkItem failed.

    If the 802.11 station is associated to a BSS network and is not performing a roaming operation, the Native 802.11 miniport driver uses this status code in its NDIS_STATUS_DOT11_DISASSOCIATION indication whenever one of the following OIDs is set:

    • OID_DOT11_RESET_REQUEST
    • OID_DOT11_DISCONNECT_REQUEST
  • DOT11_ASSOC_STATUS_ROAMING_BETTER_AP_FOUND
    If a roaming operation is pending, the Native 802.11 miniport driver can cancel the operation and return this status code if the 802.11 station detects a better BSS candidate. In this situation, the driver must do the following:

  • DOT11_ASSOC_STATUS_ROAMING_ASSOCIATION_LOST
    If the 802.11 station is associated with a BSS network and receives either an 802.11 Disassociation or Deauthentication frame from the AP, the miniport driver makes an NDIS_STATUS_DOT11_ROAMING_START indication and sets the uRoamingReason member of the DOT11_ROAMING_START_PARAMETERS structure to DOT11_ASSOC_STATUS_ROAMING_ASSOCIATION_LOST.

    Note

    DOT11_ASSOC_STATUS_ROAMING_ASSOCIATION_LOST is a generic status code that defines the reason for initiating a roaming operation after an association is lost. When making the NDIS_STATUS_DOT11_ROAMING_START indication following the receipt of an 802.11 Disassociation or Deauthentication frame, the miniport driver can use a more explicit status code. In this situation, the driver sets the uRoamingReason member of the DOT11_ROAMING_START_PARAMETERS structure to the value that is used to set the uRoamingReason member of the DOT11_DISASSOCIATION_PARAMETERS structure when the driver made the NDIS_STATUS_DOT11_DISASSOCIATION indication.

  • DOT11_ASSOC_STATUS_ROAMING_ADHOC
    If the 802.11 station is associated with an independent BSS (IBSS) network, the miniport driver can roam to another IBSS network that has the same service set identifier (SSID). In this situation, the driver roams from a smaller to a larger IBSS network.

    Before the 802.11 station performs the roaming operation, the miniport driver makes an NDIS_STATUS_DOT11_ROAMING_START indication and sets the uRoamingReason member of the DOT11_ROAMING_START_PARAMETERS structure to DOT11_ASSOC_STATUS_ROAMING_ADHOC.

  • DOT11_ASSOC_STATUS_PEER_DEAUTHENTICATED
    Specifies the status code related to BSS network deauthentication. The miniport driver returns the value of the Reason Code field from the 802.11 deauthentication frame through the following:

    (DOT11_ASSOC_STATUS_PEER_DEAUTHENTICATED | Reason Code)

    The Native 802.11 miniport driver uses this status code when one of the following occurs:

    • The 802.11 station is associated with a peer station or access point (AP), which sends the station an 802.11 deauthentication frame. In this situation, the miniport driver makes an NDIS_STATUS_DOT11_DISASSOCIATION indication and sets the uReason member of the DOT11_DISASSOCIATION_PARAMETERS structure to: (DOT11_ASSOC_STATUS_PEER_DEAUTHENTICATED | Reason Code)
    • The 802.11 station is associated with a peer station or AP, which sends the station an 802.11 deauthentication frame. In this situation, the miniport driver makes an NDIS_STATUS_DOT11_ASSOCIATION_COMPLETION indication and sets the uReason member of the DOT11_ASSOCIATION_COMPLETION_PARAMETERS structure to:
    • (DOT11_ASSOC_STATUS_PEER_DEAUTHENTICATED | Reason Code)

    For more information about the Reason Code field, refer to Clause 7.3.1.7 of the IEEE 802.11-1999 standard.

  • DOT11_ASSOC_STATUS_PEER_DISASSOCIATED
    Specifies the status code related to BSS network disassociation. The miniport driver returns the value of the Reason Code field from the 802.11 Disassociation frame through the following:

    (DOT11_ASSOC_STATUS_PEER_DISASSOCIATED | Reason Code)

    The Native 802.11 miniport driver uses this status code when it is configured for IBSS network operations and one of the following occurs:

    • The 802.11 station is associated with an AP, which sends the 802.11 station an 802.11 disassociation frame from the peer station. In this situation, the miniport driver makes an NDIS_STATUS_DOT11_DISASSOCIATION indication and sets the uReason member of the DOT11_DISASSOCIATION_PARAMETERS structure to: (DOT11_ASSOC_STATUS_PEER_DISASSOCIATED | Reason Code)
    • The 802.11 station is associating with an AP, which sends the station an 802.11 disassociation frame from the peer station. In this situation, the miniport driver makes an NDIS_STATUS_DOT11_ASSOCIATION_COMPLETION indication and sets the uReason member of the DOT11_ASSOCIATION_COMPLETION_PARAMETERS structure to:
    • (DOT11_ASSOC_STATUS_PEER_DISASSOCIATED | Reason Code)

    For more information about the Reason Code field, refer to Clause 7.3.1.7 of the IEEE 802.11-1999 standard.

  • DOT11_ASSOC_STATUS_ASSOCIATION_RESPONSE
    Specifies the status code related to BSS network association. The miniport driver returns the value of the Status Code field from either the 802.11 Association Response or Authentication frame through the following:

    (DOT11_ASSOC_STATUS_ASSOCIATION_RESPONSE | Status Code)

    The Native 802.11 miniport driver performs an association operation with an AP. This sends the station either an 802.11 Association Response or Authentication frame with a nonzero value for the Status Code field. In this situation, the miniport driver makes an NDIS_STATUS_DOT11_ASSOCIATION_COMPLETION indication and sets the uStatus member of the DOT11_ASSOCIATION_COMPLETION_PARAMETERS structure to: (DOT11_ASSOC_STATUS_ASSOCIATION_RESPONSE | Status Code)

    For more information about the Status Code field, refer to Clause 7.3.1.9 of the IEEE 802.11-1999 standard.

  • DOT11_ASSOC_STATUS_IHV_START
    Specifies the start of the range of values that can be used by the IHV to define proprietary status codes for BSS network operations
  • DOT11_ASSOC_STATUS_IHV_END
    Specifies the end of the range of values that are used for proprietary status codes for BSS network operations

Requirements

Header

windot11.h

See Also

Reference

Native 802.11 Data Types
OID_DOT11_RESET_REQUEST
OID_DOT11_DISCONNECT_REQUEST
NDIS_STATUS_DOT11_DISASSOCIATION
NdisAllocateIoWorkItem
NDIS_STATUS_DOT11_ROAMING_COMPLETION
DOT11_ROAMING_COMPLETION_PARAMETERS
NDIS_STATUS_DOT11_ROAMING_START
DOT11_ROAMING_START_PARAMETERS
DOT11_DISASSOCIATION_PARAMETERS
Native 802.11 Wireless LAN Reference