NDIS_STATUS_DOT11_CONNECTION_COMPLETION

  • 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_CONNECTION_COMPLETION indication after a connection operation completes.

The miniport driver indicates the start of the connection operation through the NDIS_STATUS_DOT11_CONNECTION_START indication. Every NDIS_STATUS_DOT11_CONNECTION_START indication made by the driver must have a corresponding NDIS_STATUS_DOT11_CONNECTION_COMPLETION indication.

For more information about the connection operation, see Connection Operations.

The data type for this indication is the DOT11_CONNECTION_COMPLETION_PARAMETERS structure:

    typedef struct DOT11_CONNECTION_COMPLETION_PARAMETERS {
         NDIS_OBJECT_HEADER Header;
         DOT11_ASSOC_STATUS uStatus;
    } DOT11_CONNECTION_COMPLETION_PARAMETERS,   *PDOT11_CONNECTION_COMPLETION_PARAMETERS;

The DOT11_CONNECTION_COMPLETION_PARAMETERS structure contains the following members:

Header
The type, revision, and size of the DOT11_CONNECTION_COMPLETION_PARAMETERS structure. This member is formatted as an NDIS_OBJECT_HEADER structure.

The miniport driver must set the members of Header to the following values:

Type
This member must be set to NDIS_OBJECT_TYPE_DEFAULT.

Revision
This member must be set to DOT11_CONNECTION_COMPLETION_PARAMETERS_REVISION_1.

Size
This member must be set to sizeof(DOT11_CONNECTION_COMPLETION_PARAMETER).

For more information about these members, see NDIS_OBJECT_HEADER.

uStatus
The completion status of the connection operation, as specified by a value defined for DOT11_ASSOC_STATUS.

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

  • StatusCode must be set to NDIS_STATUS_DOT11_CONNECTION_COMPLETION.

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

  • StatusBufferSize must be set to sizeof(DOT11_CONNECTION_COMPLETION_PARAMETERS).

The NDIS_STATUS_DOT11_CONNECTION_START and NDIS_STATUS_DOT11_CONNECTION_COMPLETION indications define a connection operation that is performed by the 802.11 station. The miniport driver cannot make the NDIS_STATUS_DOT11_CONNECTION_COMPLETION indication unless it has made an NDIS_STATUS_DOT11_CONNECTION_START indication at the beginning of the connection operation.

Requirements

Version

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

Header

 Windot11.h (include Ndis.h)