Dot11ExtSetEtherTypeHandling

Dot11ExtSetEtherTypeHandling function

The IHV Extensions DLL calls the Dot11ExtSetEtherTypeHandling function to do the following:

  • Configure the wireless LAN (WLAN) adapter with a list of packet decryption exemptions. Each exemption is applied based on the IEEE EtherType of the received packet.

  • Register with the operating system for the EtherTypes of received packets that will be forwarded to IHV Extensions DLL through calls to the Dot11ExtIhvReceivePacket IHV Handler function.

Syntax


DWORD APIENTRY Dot11ExtSetEtherTypeHandling(
  _In_opt_ HANDLE                   hDot11SvcHandle,
  _In_     ULONG                    uMaxBackLog,
  _In_     ULONG                    uNumOfExemption,
  _In_opt_ PDOT11_PRIVACY_EXEMPTION pExemption,
  _In_     ULONG                    uNumOfRegistration,
  _In_opt_ USHORT                   *pusRegistration
);

Parameters

hDot11SvcHandle [in, optional]

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

uMaxBackLog [in]

The maximum number of received packets that the operating system queues if the IHV Extensions DLL has not returned from a call to the Dot11ExtIhvReceivePacket IHV Handler function. When uMaxBackLog is reached, the operating system discards the oldest packet in the queue.

uNumOfExemption [in]

The number of entries within the privacy exemptions array referenced by the pExemption parameter. A value of zero disables privacy exemptions on the WLAN adapter.

pExemption [in, optional]

A pointer to an array of privacy exemptions. Each entry in the array is formatted as a DOT11_PRIVACY_EXEMPTION structure.

uNumOfRegistration [in]

Number of entries within the IEEE EtherType registrations array referenced by the pusRegistration parameter. A value of zero disables the ability of the IHV Extensions DLL to receive any packets through calls to the Dot11ExtIhvReceivePacket IHV Handler function.

pusRegistration [in, optional]

A pointer to an array of IEEE EtherType registrations. Each entry has the EtherType value in big-endian format.

Return value

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

Remarks

When calling the Dot11ExtSetEtherTypeHandling function, the IHV Extensions DLL must follow these guidelines:

The operating system defaults to an empty list of privacy exemptions and EtherType registrations prior to the call of the Dot11ExtIhvInitAdapter IHV Handler function.

Requirements

Target platform

Desktop

Version

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

Header

Wlanihv.h (include Wlanihv.h)

See also

DOT11_PRIVACY_EXEMPTION
Dot11ExtIhvInitAdapter
Dot11ExtIhvPerformPreAssociate
Dot11ExtIhvReceivePacket
Dot11ExtPreAssociateCompletion
Native 802.11 IHV Handler Functions

 

 

Send comments about this topic to Microsoft

Show:
© 2016 Microsoft