OID_DOT11_DISCONNECT_REQUEST

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

 

When set, the OID_DOT11_DISCONNECT_REQUEST object identifier (OID) requests that the miniport driver perform a disconnection operation from the basic service set (BSS) network with which it is connected.

No data is associated with this OID.

When OID_DOT11_DISCONNECT_REQUEST is set, the miniport driver must do the following:

  • If the 802.11 station is not connected to a BSS, fail the set request by returning NDIS_STATUS_INVALID_STATE from its MiniportOidRequest function.

  • If the 802.11 station is performing a connection operation initiated through a set request of OID_DOT11_CONNECT_REQUEST, fail the set request by returning NDIS_STATUS_INVALID_STATE from its MiniportOidRequest function. For more information about the connection operation, see Connection Operations.

  • If the 802.11 station is connected to a BSS network, perform a disconnection operation from the BSS network. For more information about the disconnection operation, see Disconnection Operations.

  • The 802.11 station must not power the radio off.

  • The miniport driver must transition to the INIT state of the Extensible Station (ExtSTA) operation mode. For more information about operation modes and related states, see Extensible Station Operation Mode.

  • The 802.11 station must stay disconnected from any BSS network until the next set request of OID_DOT11_CONNECT_REQUEST.

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

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

  • Initiate the disconnection operation and complete the set request. The miniport driver must return NDIS_STATUS_PENDING from its MiniportOidRequest function after initiating the disconnection operation. After the disconnection operation has finished, the miniport driver completes the set request by calling NdisMRequestComplete.The miniport driver also makes the NDIS_STATUS_DOT11_CONNECTION_COMPLETION asynchronously after the set request.

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