Dot11ExtSetEtherTypeHandling (Compact 2013)

3/26/2014

The IHV Extensions DLL calls this 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 WINAPI  Dot11ExtSetEtherTypeHandling(
    HANDLE hDot11SvcHandle,
    ULONG uMaxBackLog,
    ULONG uNumOfExemption,
    PDOT11_PRIVACY_EXEMPTION pExemption,
    ULONG uNumOfRegistration,
    PUSHORT pusRegistration
);

Parameters

• hDot11SvcHandle
  [in] The handle that is 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 that is referenced by the pExemption parameter. A value of zero disables privacy exemptions on the WLAN adapter.

• pExemption
  [in] 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 that are 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] 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 it calls the Dot11ExtSetEtherTypeHandling function, the IHV Extensions DLL must follow these guidelines:

• The IHV Extensions DLL can call Dot11ExtSetEtherTypeHandling from inside the calls to either the Dot11ExtIhvInitAdapter or Dot11ExtIhvPerformPreAssociate IHV Handler functions.
• The IHV Extensions DLL must not call Dot11ExtSetEtherTypeHandling after successfully completing the pre-association operation through a call to Dot11ExtPreAssociateCompletion.

The operating system uses an empty list of privacy exemptions and EtherType registrations before the call of the Dot11ExtIhvInitAdapter IHV Handler function.

Requirements

Header

wlanihv.h

See Also

Reference

Native 802.11 IHV Extensibility Functions
Dot11ExtIhvReceivePacket
Dot11ExtIhvInitAdapter
DOT11_PRIVACY_EXEMPTION
Dot11ExtIhvInitAdapter
Dot11ExtIhvPerformPreAssociate
Dot11ExtPreAssociateCompletion
Native 802.11 IHV Extensions DLL