NDIS_STATUS_DOT11_CONNECTION_START

  • 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_START indication after the set request of OID_DOT11_CONNECT_REQUEST. This indication defines the start of the connection operation, in which the 802.11 station attempts to connect to a basic service set (BSS) network.

The miniport driver indicates the completion of the connection operation through the NDIS_STATUS_DOT11_CONNECTION_COMPLETION 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 connection operations, see Connection Operations.

The data type for this indication is the DOT11_CONNECTION_START_PARAMETERS structure:

    typedef struct DOT11_CONNECTION_START_PARAMETERS {
         NDIS_OBJECT_HEADER Header;
         DOT11_BSS_TYPE BSSType;
         DOT11_MAC_ADDRESS AdhocBSSID;
         DOT11_SSID AdhocSSID;
    } DOT11_CONNECTION_START_PARAMETERS,   *PDOT11_CONNECTION_START_PARAMETERS;

The DOT11_CONNECTION_START_PARAMETERS structure contains the following members:

Header
The type, revision, and size of the DOT11_CONNECTION_START_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_START_PARAMETERS_REVISION_1.

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

For more information about these members, see NDIS_OBJECT_HEADER.

BssType
The type of BSS network that the 802.11 station is connecting to. The data type for the BssType member is the DOT11_BSS_TYPE enumeration.

The 802.11 station connects to a BSS type based on the setting of the IEEE 802.11 dot11DesiredBssType MIB object. For more information about this MIB object, see OID_DOT11_DESIRED_BSS_TYPE.

AdhocBSSID
If BssType is set to dot11_BSS_type_independent, the AdhocBSSID member contains the BSS identifier (BSSID) of the IBSS network that the 802.11 station will join or start.

Note  IBSS (Ad hoc) and SoftAP are deprecated. Starting with Windows 8.1 and Windows Server 2012 R2, use Wi-Fi Direct.

 

If BssType is set to dot11_BSS_type_infrastructure, the miniport driver must fill AdhocBSSID with zeros.

For more information about the data type for this member, see DOT11_MAC_ADDRESS.

AdhocSSID
If BssType is set to dot11_BSS_type_independent, the AdhocSSID member contains the service set identifier (SSID) of the IBSS network that the 802.11 station will join or start.

Note  IBSS (Ad hoc) and SoftAP are deprecated. Starting with Windows 8.1 and Windows Server 2012 R2, use Wi-Fi Direct.

 

If BssType is set to dot11_BSS_type_infrastructure, the miniport driver must fill AdhocSSID with zeros.

For more information about the data type for this member, see DOT11_SSID.

After the set request of OID_DOT11_CONNECT_REQUEST is made, the 802.11 station begins the connection operation by using the BSS parameters that were previously configured through set requests of Native 802.11 OIDs. The miniport driver begins the connection operation by calling 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 driver must set the following members of the NDIS_STATUS_INDICATION structure:

  • StatusCode must be set to NDIS_STATUS_DOT11_CONNECTION_START.

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

  • StatusBufferSize must be set to sizeof(DOT11_CONNECTION_START_PARAMETERS).

After the 802.11 station connects to a BSS network or has failed to connect to any BSS network, the miniport driver indicates the completion of the connection operation through an NDIS_STATUS_DOT11_CONNECTION_COMPLETION indication.

After the 802.11 station starts the connection operation, the miniport driver must complete the connection operation by making an NDIS_STATUS_DOT11_CONNECTION_COMPLETION indication before it makes the following indications:

After the miniport driver makes the NDIS_STATUS_DOT11_CONNECTION_START indication, it cannot make another NDIS_STATUS_DOT11_CONNECTION_START indication until:

Before it initiates a connection operation, the miniport driver must allocate all of the resources that it will need to make the corresponding NDIS_STATUS_DOT11_CONNECTION_COMPLETION indication.

Requirements

Version

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

Header

 Windot11.h (include Ndis.h)