Skip to content

Latest commit

 

History

History
137 lines (99 loc) · 5.03 KB

nc-wlanihv-dot11ext_process_onex_packet.md

File metadata and controls

137 lines (99 loc) · 5.03 KB
Raw
UID title description old-location tech.root ms.date keywords ms.keywords req.header req.include-header req.target-type req.target-min-winverclnt req.target-min-winversvr req.kmdf-ver req.umdf-ver req.ddi-compliance req.unicode-ansi req.idl req.max-support req.namespace req.assembly req.type-library req.lib req.dll req.irql targetos req.typenames f1_keywords topic_type api_type api_location api_name
NC:wlanihv.DOT11EXT_PROCESS_ONEX_PACKET
DOT11EXT_PROCESS_ONEX_PACKET (wlanihv.h)
The DOT11EXT_PROCESS_ONEX_PACKET callback function is part of the Native 802.11 Wireless LAN interface, which is deprecated for Windows 10 and later.
netvista\dot11extprocessonexpacket.htm
netvista
02/16/2018
DOT11EXT_PROCESS_ONEX_PACKET callback
DOT11EXT_PROCESS_ONEX_PACKET, Dot11ExtProcessOneXPacket, Dot11ExtProcessOneXPacket callback function [Network Drivers Starting with Windows Vista], Native_802.11_IHV_Ext_261bf893-01bf-45d2-96da-b11745a2ae56.xml, netvista.dot11extprocessonexpacket, wlanihv/Dot11ExtProcessOneXPacket
wlanihv.h
Wlanihv.h
Desktop
Available in Windows Vista and later versions of the Windows operating systems.
Windows
DRIVER_INFO_8W, *PDRIVER_INFO_8W, *LPDRIVER_INFO_8W
DOT11EXT_PROCESS_ONEX_PACKET
wlanihv/DOT11EXT_PROCESS_ONEX_PACKET
APIRef
kbSyntax
UserDefined
wlanihv.h
DOT11EXT_PROCESS_ONEX_PACKET

DOT11EXT_PROCESS_ONEX_PACKET callback

-description

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 IHV Extensions DLL calls the Dot11ExtProcessOneXPacket function to forward EAP over LAN (EAPOL) packets to the operating system for processing during an 802.1X authentication operation with the access point (AP).

-parameters

-param hDot11SvcHandle [in, optional]

The handle used by the operating system to reference the wireless LAN (WLAN) adapter. This handle value was specified through a previous call to the Dot11ExtIhvInitAdapter IHV Handler function.

-param dwInPacketSize [in]

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

-param pvInPacket [in]

The EAPOL packet received from the AP. The pvInPacket parameter must reference the EAPOL packet starting from the packet type field in the EAPOL protocol data unit (PDU). For more information about the EAPOL packet type field, refer to Clause 7.5.4 in the IEEE 802.1X-2001 standard.

-returns

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

-prototype

DWORD WINAPI * Dot11ExtProcessOneXPacket(
  _In_opt_ HANDLE hDot11SvcHandle,
  _In_     DWORD  dwInPacketSize,
  _In_     LPVOID pvInPacket
);

-remarks

When it calls the Dot11ExtStartOneX function, the IHV Extensions DLL initiates an 802.1X authentication operation by using the 802.1X module of the Native 802.11 framework. This allows the DLL to use the standard extensible authentication protocol (EAP) algorithms that are supported by the operating system.

While the 802.1X authentication operation is pending, the IHV Extensions DLL forwards received EAP over LAN (EAPOL) packets to the operating system through a call to the Dot11ExtProcessOneXPacket function. The IHV Extensions DLL receives these packets through the Dot11ExtIhvReceivePacket IHV Handler function.

Note  The IHV Extensions DLL is responsible for processing EAPOL-Key packets and must not forward these to the operating system.
 
For more information about EAPOL packets, refer to Clause 7 of the IEEE 802.1X-2001 standard.

For more information about using the 802.1X module for authentication, see Interface to the Native 802.11 802.1X Module

-see-also

Dot11ExtIhvReceivePacket

Dot11ExtIhvInitAdapter

Dot11ExtIhvOneXIndicateResult

Dot11ExtStartOneX

Dot11ExtStopOneX