NDIS_STATUS_DOT11_CONNECTION_START (Compact 2013)

Article
07/31/2017

3/26/2014

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 tries 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.

The data type for this indication is the DOT11_CONNECTION_START_PARAMETERS structure:

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 it makes 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:

The miniport driver returns to the Extensible Station (ExtSTA) INIT mode through a set request of either OID_DOT11_DISCONNECT_REQUEST or OID_DOT11_RESET_REQUEST.
A set request of OID_DOT11_CONNECT_REQUEST is made

Before it starts a connection operation, the miniport driver must allocate all resources that it must make the corresponding NDIS_STATUS_DOT11_CONNECTION_COMPLETION indication.

NDIS_STATUS_DOT11_CONNECTION_START (Compact 2013)

See Also

Reference

Additional resources