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.


typedef ULONG DOT11_ASSOC_STATUS;

DOT11_ASSOC_STATUS_SUCCESS

The network operation completed successfully

DOT11_ASSOC_STATUS_FAILURE

The network operation completed with a failure

Gg155791.note(en-us,WinEmbedded.80).gifNote:
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.

Gg155791.note(en-us,WinEmbedded.80).gifNote:
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.

Gg155791.note(en-us,WinEmbedded.80).gifNote:
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

Header

windot11.h

Show: