DOT11EXTIHV_INIT_VIRTUAL_STATION callback function (wlanihv.h)

Article
10/21/2021

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 Dot11ExtIhvInitVirtualStation function to initialize the IHV Extensions DLL for virtual station operations, and to initialize the API interface between the operating system and the DLL.

Syntax

DOT11EXTIHV_INIT_VIRTUAL_STATION Dot11extihvInitVirtualStation;

DWORD Dot11extihvInitVirtualStation(
  [in] PDOT11EXT_VIRTUAL_STATION_APIS pDot11ExtVSAPI,
       LPVOID pvReserved
)
{...}

Parameters

[in] pDot11ExtVSAPI

A pointer to a DOT11EXT_VIRTUAL_STATION_APIS structure, which contains the addresses of the IHV Extensibility virtual station functions that are supported by the operating system. The operating system formats this parameter with the function addresses before making a call to the Dot11ExtIhvInitVirtualStation function.

pvReserved

This parameter is reserved for use by the operating system and should be NULL.

Return value

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

Remarks

It is optional for the IHV Extensions DLL to implement and export this function.

The operating system calls the Dot11ExtIhvInitVirtualStation function immediately after it calls the Dot11ExtIhvInitService function, but before it calls the Dot11ExtIhvInitAdapter function.

In response to a call to Dot11ExtIhvInitVirtualStation, the IHV Extensions DLL can initialize its internal data structures with the information provided from the Dot11ExtIhvInitService function call.

Note The IHV Extensions DLL is allowed to call the virtual station API functions that the pDot11ExtVSAPI parameter points to only after the Dot11ExtIhvInitVirtualStation function returns.

The operating system resolves the address of the Dot11ExtIhvInitVirtualStation function by calling the GetProcAddress function. As a result, the developer of the IHV Extensions DLL must follow these guidelines if this function is implemented.

The DLL must implement a function named Dot11ExtIhvInitVirtualStation, 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 Dot11ExtIhvInitVirtualStation function.

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

Requirements

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