DOT11_ASSOC_STATUS status codes

The DOT11_ASSOC_STATUS 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;

Status codes

Available status codes are defined as follows:

DOT11_ASSOC_STATUS_SUCCESS
The network operation completed successfully.

DOT11_ASSOC_STATUS_FAILURE
The network operation completed with a failure.

DOT11_ASSOC_STATUS_UNREACHABLE
The network operation failed because the 802.11 station determined that the peer station or access point (AP) is unresponsive due to 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 due to other proprietary methods 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.

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

• The Native 802.11 miniport driver issued a set request of OID_DOT11_RESET_REQUEST.
• The Native 802.11 miniport driver issued a set request of OID_DOT11_DISCONNECT_REQUEST.

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 status 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 performed by the Native 802.11 miniport driver. For more information about this operation, see Implicit Disassociation Operations.

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 status 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:

• Make an NDIS_STATUS_DOT11_ROAMING_COMPLETION indication and set the uStatus member of the DOT11_ROAMING_COMPLETION_PARAMETERS structure to DOT11_ASSOC_STATUS_ROAMING_BETTER_AP_FOUND.
• Make an NDIS_STATUS_DOT11_ROAMING_START indication before attempting to roam to the new BSS candidate.

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

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.

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 with 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 status 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 status 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 associating 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 status 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 8.4.1.7 of the IEEE 802.11-2012 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 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 status 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 status 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 8.4.1.7 of the IEEE 802.11-2012 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, which 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 status 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 8.4.1.9 of the IEEE 802.11-2012 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 used for proprietary status codes for BSS network operations.

Remarks

For more information about network operations performed by a Native 802.11 miniport driver, see Native 802.11 Network Operations.

Requirements