DOT11EXTIHV_ADAPTER_RESET callback function (wlanihv.h)

Article
02/22/2024

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.

The operating system calls the IHV Extensions DLL Dot11ExtIhvAdapterReset function to reset the wireless LAN (WLAN) adapter.

Syntax

DOT11EXTIHV_ADAPTER_RESET Dot11extihvAdapterReset;

DWORD Dot11extihvAdapterReset(
  [in, optional] HANDLE hIhvExtAdapter
)
{...}

Parameters

[in, optional] hIhvExtAdapter

The handle used by the IHV Extensions DLL to reference the WLAN adapter. This handle value was specified through a previous call to the Dot11ExtIhvInitAdapter IHV Handler function.

Return value

If the call succeeds, the function returns ERROR_SUCCESS. Otherwise, it returns an error code defined in Winerror.h.

Remarks

The operating system calls Dot11ExtIhvAdapterReset whenever one of the following events occurs.

The WLAN adapter performs a disconnection operation. For more information about this operation, see Disconnection Operations.
The operating system resets the Native 802.11 miniport driver, which manages the adapter, through a set request of OID_DOT11_RESET_REQUEST.

The Dot11ExtIhvAdapterReset function must restore the WLAN adapter to the same state as when the DLL's Dot11ExtIhvInitAdapter function was called.

For more information about the reset operation for WLAN adapters, see 802.11 WLAN Adapter Reset.

Requirements

Requirement	Value
Minimum supported client	Available in Windows Vista and later versions of the Windows operating systems.
Target Platform	Desktop
Header	wlanihv.h (include Wlanihv.h)