DOT11EXTIHV_RECEIVE_PACKET callback function (wlanihv.h)

The operating system calls the Dot11ExtIhvReceivePacket function to forward a packet, received by the wireless LAN (WLAN) adapter, to the IHV Extensions DLL for processing.

Syntax

DOT11EXTIHV_RECEIVE_PACKET Dot11extihvReceivePacket;

DWORD Dot11extihvReceivePacket(
  [in, optional] HANDLE hIhvExtAdapter,
  [in]           DWORD dwInBufferSize,
  [in]           LPVOID pvInBuffer
)
{...}

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] dwInBufferSize

The length, in bytes, of the received packet referenced by the pvInBuffer parameter.

[in] pvInBuffer

A pointer to a buffer, allocated by the operating system, which contains the packet data, as described in the Remarks section.

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 Dot11ExtIhvReceivePacket function when the following occur:

• The WLAN adapter receives a packet and the Native 802.11 miniport driver, which manages the adapter, indicates the packet to the operating system.
• The packet's IEEE EtherType matches an entry in the list of EtherTypes specified by the IHV Extensions DLL through a call to the Dot11ExtSetEtherTypeHandling function.

The buffer pointed to by pvPacket should contain the following packet data, specified in network byte order:

• MAC address of destination (6 bytes), formatted according to the guidelines discussed in 802.11 MAC Header Management
• IEEE EtherType (2 bytes)
• Payload

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)

See also

Dot11ExtSetEtherTypeHandling

Dot11ExtIhvInitAdapter