Edit

OID_WDI_TASK_DOT11_RESET

  • Article

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_DOT11_RESET requests that the IHV component resets the MAC and PHY state on a specified port.

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

Prior to issuing a dot11 reset command, the WDI driver stops issuing new commands to IHV component and aborts any task in progress on the port. It also flushes its Rx and TX queues.

The dot11 reset combines the semantics of the 802.11 MLME and PLME reset primitive. When the IHV component receives a dot11 reset request, it should perform the following tasks.

  • Reset the port’s MAC entity to its initial state.
  • Reset the port’s MIB attributes so they are set to their default values, if bSetDefaultMIB is true.
  • Reset the TX/Rx state machines for the PHY entity and set it to Rx state only to ensure no more frames are transmitted.
  • Flush the adapter’s Rx queue and complete the send for each packet in the TX queues.
  • If the MAC address parameter is present, reset the port’s MAC address to the specified value.
  • Set the port state to INIT before completing the dot11 reset operation.

If the port being reset was operating as a STA, AP, or a Wi-Fi Direct Client or GO, the host would have triggered the disconnect task to request the IHV component to send disassociation to the peers before the reset. As such, the IHV component does not need to do it again.

Task parameters

TLV Multiple TLV instances allowed Optional Description
WDI_TLV_DOT11_RESET_PARAMETERS Parameters for the dot11 reset.
WDI_TLV_CONFIGURED_MAC_ADDRESS X The MAC address that should be used for the port.

Task completion indication

NDIS_STATUS_WDI_INDICATION_DOT11_RESET_COMPLETE

Requirements

Minimum supported client

Windows 10

Minimum supported server

Windows Server 2016

Header

 Dot11wdi.h