DOT11EXTIHV_INIT_ADAPTER 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 Dot11ExtIhvInitAdapter function to have the IHV Extensions DLL allocate and initialize an adapter context.

Syntax

DOT11EXTIHV_INIT_ADAPTER Dot11extihvInitAdapter;

DWORD Dot11extihvInitAdapter(
  [in]           PDOT11_ADAPTER pDot11Adapter,
  [in, optional] HANDLE hDot11SvcHandle,
  [out]          PHANDLE phIhvExtAdapter
)
{...}

Parameters

[in] pDot11Adapter

A pointer to a DOT11_ADAPTER structure, which identifies the adapter to be initialized.

[in, optional] hDot11SvcHandle

A handle assigned by the operating system for the adapter. The IHV Extensions DLL must use this handle value when calling any IHV Extensibility function that declares an hDot11SvcHandle parameter, such as Dot11ExtPreAssociateCompletion.

[out] phIhvExtAdapter

A pointer to a handle variable. The IHV Extensions DLL must assign a unique handle value for the adapter and set * phIhvExtAdapter to the handle value. The operating system uses this handle value when it calls any IHV Handler function that declares an hIhvExtAdapter parameter, such as Dot11ExtIhvPerformPreAssociate.

Typically, the IHV Extensions DLL allocates a state array for the adapter context and returns the address of the array as the handle value.

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 the Dot11ExtIhvInitAdapter function whenever a WLAN adapter becomes available and enabled for use, such as when a PCMCIA adapter is inserted.

For more information about WLAN adapter initialization, see 802.11 WLAN Adapter Arrival.

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)