Dot11ExtIhvReceivePacket routine

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 APIENTRY Dot11ExtIhvReceivePacket(
  _In_opt_  HANDLE hIhvExtAdapter,
  _In_      DWORD dwInBufferSize,
  _In_      LPVOID pvInBuffer
)
{ ... }

Parameters

hIhvExtAdapter [in, optional]

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.

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, 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

Version

Available in Windows Vista and later versions of the Windows operating systems.

Header

Wlanihv.h (include Wlanihv.h)

See also

Dot11ExtIhvInitAdapter
Dot11ExtSetEtherTypeHandling

 

 

Send comments about this topic to Microsoft

Show:
© 2014 Microsoft