DOT11EXTIHV_GET_VERSION_INFO 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 Dot11ExtIhvGetVersionInfo function immediately after loading the IHV Extensions DLL to determine the version of the interface supported by the DLL.

Syntax

DOT11EXTIHV_GET_VERSION_INFO Dot11extihvGetVersionInfo;

DWORD Dot11extihvGetVersionInfo(
  [out] PDOT11_IHV_VERSION_INFO pDot11IHVVersionInfo
)
{...}

Parameters

[out] pDot11IHVVersionInfo

A pointer to a DOT11_IHV_VERSION_INFO structure, which contains the interface version numbers.

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 Dot11ExtIhvGetVersionInfo function to determine what version of the interface to use with the IHV Extension DLL. The operating system makes this call immediately after loading the DLL, and this call is the first that the operating system makes into the DLL.

Unlike other IHV Extensibility and Handler functions, whose addresses are resolved through a table of function pointers that are exchanged through a call to Dot11ExtIhvInitService, the address of the Dot11ExtIhvGetVersionInfo function is resolved by the operating system by the operating system calling the GetProcAddress function. As a result, the developer of the IHV Extensions DLL must follow these guidelines.

The DLL must implement a function named Dot11ExtIhvGetVersionInfo, which has the format that is described in this topic.
The EXPORTS statement of the source module-definition (.def) file, which is used to build the IHV Extensions DLL, must contain a function name entry for the Dot11ExtIhvGetVersionInfo function.

For more information about GetProcAddress, refer to the Microsoft Windows SDK documentation.

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)