OID_WDI_TASK_DISCONNECT

Important

This topic is part of the WDI driver model released in Windows 10. The WDI driver model is in maintenance mode and will only receive high priority fixes. WiFiCx is the Wi-Fi driver model released in Windows 11. We recommend that you use WiFiCx to take advantage of the latest features.

OID_WDI_TASK_DISCONNECT is used to terminate a connection with a peer.

Object Abort capable Default priority (host driver policy) Normal execution time (seconds)
Port No 2 1

This command is used to disconnect from an Access Point or a Wi-Fi Direct GO, and also to disconnect clients of the port. When the disconnect is received, the port must disassociate and deauthenticate from the peer and clear the state associated with that peer. However, it must not reset any of the connection parameters that are not specific to this peer. The task must be completed only after the disconnect activity has been completed.

Task parameters

TLV Multiple TLV instances allowed Optional Description
WDI_TLV_DISCONNECT_PARAMETERS The disconnect parameters.

Task completion indication

NDIS_STATUS_WDI_INDICATION_DISCONNECT_COMPLETE

Unsolicited indication

NDIS_STATUS_WDI_INDICATION_DISASSOCIATION When the port gets disconnected from the network, it sends the disassociation indication to the OS. The disconnect may be triggered by a command from the OS, or may be triggered from the network. Network triggered disconnects may be explicit from received disassociation or deauthentication packets, or may be implicit when the port cannot detect the presence of the peer it is connected to.

Before the disassociation indication is sent, the port must clear the state associated with the peer. This includes any keys and 802.1x port authorization information associated with the peer. The port must not trigger a roam on its own.

Requirements

Minimum supported client

Windows 10

Minimum supported server

Windows Server 2016

Header

Dot11wdi.h