DOT11EXTIHV_RECEIVE_INDICATION 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 Dot11ExtIhvReceiveIndication function to issue an IHV-specific indication to the IHV Extensions DLL from the wireless LAN (WLAN) adapter.

Syntax

DOT11EXTIHV_RECEIVE_INDICATION Dot11extihvReceiveIndication;

DWORD Dot11extihvReceiveIndication(
  [in, optional] HANDLE hIhvExtAdapter,
  [in]           DOT11EXT_IHV_INDICATION_TYPE indicationType,
  [in]           ULONG uBufferLength,
  [in, optional] LPVOID pvBuffer
)
{...}

Parameters

[in, optional] hIhvExtAdapter

The handle used by the IHV Extensions DLL to reference the WLAN adapter. This handle value was specified through a previous call to the Dot11ExtIhvInitAdapter IHV Handler function.

[in] indicationType

The DOT11EXT_IHV_INDICATION_TYPE indication type.

[in] uBufferLength

The length, in bytes, of the data within the buffer that is referenced by the pvBuffer parameter.

[in, optional] pvBuffer

The pointer to a buffer, allocated by the operating system, which contains the notification data. The IHV is responsible for defining the format of the notification data.

Return value

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

Remarks

When the Native 802.11 miniport driver, which manages the WLAN adapter, makes an NDIS_STATUS_MEDIA_SPECIFIC_INDICATION indication, the operating system forwards the notification data to the IHV Extensions DLL by calling the Dot11ExtIhvReceiveIndication function.

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)