OID_DOT11_CONNECT_REQUEST

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.

 

When set, the OID_DOT11_CONNECT_REQUEST object identifier (OID) requests that the miniport driver perform a connection operation to a basic service set (BSS) network. For more information about the connection operation, see Connection Operations.

No data is associated with this OID.

If the connection operation completes successfully, the miniport driver must transition to the Extensible Station (ExtSTA) operational (OP) state. The miniport driver must remain in the ExtSTA OP state until either a method request of OID_DOT11_RESET_REQUEST or set request of OID_DOT11_DISCONNECT_REQUEST is made. For more information about this state, see Extensible Station Operating States.

When OID_DOT11_CONNECT_REQUEST is set, the miniport driver must fail the request by returning NDIS_STATUS_POWER_STATE_INVALID from its MiniportOidRequest function if any of the following are true:

  • All of the PHYs specified through the ExtSTA msDot11DesiredPhyList MIB object are turned off through sets of OID_DOT11_NIC_POWER_STATE. For more information about this MIB object, see OID_DOT11_DESIRED_PHY_LIST.

  • All of the PHYs specified through the ExtSTA msDot11DesiredPhyList MIB object are turned off through a hardware switch setting or proprietary software setting.

  • Additional criteria apply for the connection request to fail, as described in General Connection Operation Guidelines.

When OID_DOT11_CONNECT_REQUEST is set, the miniport driver can do one of the following:

  • Wait for the connection operation to complete before completing the set request.

  • Initiate the connection operation and complete the set request. In this situation, the miniport driver must return NDIS_STATUS_PENDING from its MiniportOidRequest function after initiating the connection operation. After the reset operation has finished, the miniport driver completes the set request by calling NdisMRequestComplete.

Requirements

Version

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

Header

Windot11.h (include Ndis.h)

See also

Native 802.11 Wireless LAN OIDs