NDIS_STATUS_DOT11_CONNECTION_START (Compact 2013)
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.
See Also
Reference
Native 802.11 Extensible Station Status Indications
OID_DOT11_CONNECT_REQUEST
NDIS_STATUS_DOT11_CONNECTION_COMPLETION
DOT11_CONNECTION_START_PARAMETERS
NdisMIndicateStatusEx
NDIS_STATUS_INDICATION
NDIS_STATUS_DOT11_ROAMING_START
NDIS_STATUS_DOT11_ROAMING_COMPLETION
OID_DOT11_DISCONNECT_REQUEST
NDIS_STATUS_DOT11_CONNECTION_COMPLETION
Native 802.11 Wireless LAN Status Indications