Bewerken

Delen via

DOT11EXTIHV_RECEIVE_PACKET callback function (wlanihv.h)

  • Artikel
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 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