DOT11EXT_REQUEST_VIRTUAL_STATION - NtDoc

Native API online documentation, based on the System Informer (formerly Process Hacker) phnt headers
// wlanihv.h

DOT11EXT_REQUEST_VIRTUAL_STATION Dot11extRequestVirtualStation;

DWORD Dot11extRequestVirtualStation(
  [in, optional] HANDLE hDot11PrimaryHandle,
                 LPVOID pvReserved
)
{...}
View the official Windows Driver Kit DDI reference

NtDoc

No description available.

Windows Driver Kit DDI reference (nc-wlanihv-dot11ext_request_virtual_station)

DOT11EXT_REQUEST_VIRTUAL_STATION callback

Description

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 IHV Extensions DLL calls the Dot11ExtRequestVirtualStation function to request that the operating system create a virtual 802.11 station.

Parameters

hDot11PrimaryHandle [in, optional]

A handle used by the operating system to reference the primary physical wireless LAN (WLAN) adapter. This handle value was received as the hDot11SvcHandle parameter through a previous call to the Dot11ExtIhvInitAdapter IHV Handler 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.

Prototype

DWORD WINAPI * Dot11ExtRequestVirtualStation(
  _In_opt_   HANDLE hDot11PrimaryHandle,
  _Reserved_ LPVOID pvReserved
);

Remarks

When this request function completes successfully, the operating system begins to process the request to create a virtual station. It is possible that the operating system will call the Dot11ExtIhvInitAdapter IHV Handler function to initialize the virtual station before or after the call to Dot11ExtRequestVirtualStation returns.

After the operating system creates the new virtual station, the IHV Extensions DLL should expect to receive a call to the Dot11ExtIhvInitAdapter IHV Handler function. In this call, the operating system passes a handle to the new virtual adapter through the hDot11SvcHandle parameter.

See also

Dot11ExtReleaseVirtualStation

Dot11ExtIhvInitAdapter