Dot11ExtIhvReceivePacket (Compact 2013)

3/26/2014

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

Syntax

DWORD WINAPI Dot11ExtIhvReceivePacket(
    HANDLE hIhvExtAdapter,
    DWORD dwInBufferSize,
    LPVOID pvInBuffer
); 

Parameters

  • hIhvExtAdapter
    [in] The handle that is 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.
  • dwInBufferSize
    [in] The length, in bytes, of the received packet referenced by the pvInBuffer parameter.
  • pvInBuffer
    [in] A pointer to a buffer, allocated by the operating system, which contains the packet data. This includes the 802.11 media access control (MAC) header.

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.

Requirements

Header

wlanihv.h

See Also

Reference

Native 802.11 IHV Handler Functions
Dot11ExtIhvInitAdapter
Dot11ExtSetEtherTypeHandling
Native 802.11 IHV Extensions DLL