DOT11EXT_SEND_UI_REQUEST 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 Dot11ExtSendUIRequest function to request user notification or input through the Native 802.11 IHV UI Extensions DLL.

Parameters

hDot11SvcHandle [in, optional]

The handle used by the operating system to reference the wireless LAN (WLAN) adapter. This handle value was specified through a previous call to the Dot11ExtIhvInitAdapter IHV Handler function.

pIhvUIRequest [in]

A pointer to a caller-allocated buffer, formatted as a DOT11EXT_IHV_UI_REQUEST structure.

Return value

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

Prototype

DWORD WINAPI * Dot11ExtSendUIRequest(
  _In_opt_ HANDLE                   hDot11SvcHandle,
  _In_     PDOT11EXT_IHV_UI_REQUEST pIhvUIRequest
);

Remarks

The IHV Extensions DLL must follow these guidelines when calling the Dot11ExtSendUIRequest function.

• Requests for event notification by the Native 802.11 IHV UI Extensions DLL are completed through a call to the Dot11ExtIhvProcessUIResponse IHV Handler function. The IHV Extensions DLL must not free the memory referenced by the pIhvUIRequest parameter until the request is completed.
• If the operating system calls the Dot11ExtIhvAdapterReset or Dot11ExtIhvDeinitAdapter IHV handler functions, the IHV Extensions DLL can assume that the UI request has been canceled. In this situation, the DLL must free the memory referenced by the pIhvUIRequest parameter.
• The operating system can query the completion status of the request through a call to the Dot11ExtIhvIsUIRequestPending IHV Handler function.

See also

Dot11ExtIhvAdapterReset

Dot11ExtIhvDeinitAdapter

Dot11ExtIhvProcessUIResponse

Dot11ExtIhvInitAdapter

Dot11ExtIhvIsUIRequestPending