OID_WDI_TASK_DISCONNECT (dot11wificxintf.h)
Important
This topic is part of the WiFiCx driver model. WiFiCx is the Wi-Fi driver model released in Windows 11. We recommend that you use WiFiCx to take advantage of the latest features. The previous Wi-Fi driver model WDI is in maintenance mode and will only receive high priority fixes.
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
| Requirement | Value |
|---|---|
| Minimum supported client | Windows 11 |
| Minimum supported server | Windows Server 2022 |
| Header | dot11wificxintf.h |