Native 802.11 IHV Extensibility Functions (Compact 2013)

3/26/2014

The Native 802.11 IHV Extensibility functions are provided by the operating system and are called by the IHV Extensions DLL to do the following:

• Allocate and free buffers that are used within the Native 802.11 framework
• Send packets, such as a packet defined by an authentication algorithm, through the IHV’s wireless LAN (WLAN) adapter
• Configure the IHV's WLAN adapter with various security settings for any authentication and cipher algorithms supported by the IHV Extensions DLL

Note

The IHV Extensions DLL calls each Native 802.11 IHV Extensibility function through a function pointer associated with a member of the DOT11EXT_APIS structure. When the operating system calls the Dot11ExtIhvInitService IHV Handler function, it passes the list of pointers to the IHV Extensibility functions through the pDot11ExtAPI parameter.

The Native 802.11 IHV Extensibility Functions that can be called by the IHV Extensions DLL are listed here (each IHV Extensibility function can only be called under these conditions):

• Called After Service Initialization
  The IHV Extensibility function can be called only after the Dot11ExtIhvInitService IHV Handler function has been called to initialize the IHV Extensions DLL. The Extensions DLL cannot call the IHV Extensibility function after the Dot11ExtIhvDeinitService IHV Handler function has been called.

• Called after Adapter Initialization
  The IHV Extensibility function can only be called after the Dot11ExtIhvInitAdapter IHV Handler function has been called to initialize the interface to the IHV’s WLAN adapter.

  The IHV Extensibility function requires a handle, which identifies the WLAN adapter. When Dot11ExtIhvAdapterReset is called, the IHV Extensions DLL is passed this handle through the hDot11SvcHandle parameter.

  The Extensions DLL cannot call the IHV Extensibility function after the Dot11ExtIhvDeinitAdapter IHV Handler function has been called.

• Called after Pre-Association
  The IHV Extensibility function can only be called after the Dot11ExtIhvPerformPreAssociate IHV Handler function has been called to start a pre-association operation with a basic service set (BSS) network.

  The IHV Extensibility function requires a handle, which identifies the BSS network connection. When Dot11ExtIhvPerformPreAssociate is called, the IHV Extensions DLL is passed this handle through the hConnection parameter.

  The Extensions DLL cannot call the IHV Extensibility function after the Dot11ExtIhvDeinitAdapter or Dot11ExtIhvAdapterReset IHV Handler functions have been called.

• Called after Post-Association
  The IHV Extensibility function can only be called after the Dot11ExtIhvPerformPostAssociate IHV Handler function has been called to start a post-association operation with a basic service set (BSS) network.

  The IHV Extensibility function requires a handle, which identifies the security session with the BSS network connection. When Dot11ExtIhvPerformPostAssociate is called, the IHV Extensions DLL is passed this handle through the hSecuritySessionID parameter.

  The Extensions DLL cannot call the IHV Extensibility function after the Dot11ExtIhvDeinitAdapter or Dot11ExtIhvAdapterReset IHV Handler functions have been called.

In This Section

Function	Called After:
Dot11ExtAllocateBuffer	Service Initialization
Dot11ExtFreeBuffer	Service Initialization
Dot11ExtGetProfileCustomUserData	Pre-Association
Dot11ExtNicSpecificExtension	Adapter Initialization
Dot11ExtStartOneX	Post-Association
Dot11ExtOneXStop	Post-Association
Dot11ExtPostAssociateCompletion	Post-Association
Dot11ExtPreAssociateCompletion	Pre-Association
Dot11ExtProcessOneXPacket	Post-Association
Dot11ExtSendNotification	Adapter Initialization
Dot11ExtSetAuthAlgorithm	Adapter Initialization
Dot11ExtSetCurrentProfile	Pre-Association
Dot11ExtSetDefaultKey	Adapter Initialization
Dot11ExtSetDefaultKeyId	Adapter Initialization
Dot11ExtSetEtherTypeHandling	Adapter Initialization
Dot11ExtSetExcludeUnencrypted	Adapter Initialization
Dot11ExtSetKeyMappingKey	Adapter Initialization
Dot11ExtSetMulticastCipherAlgorithm	Adapter Initialization
Dot11ExtSetProfileCustomUserData	Adapter Initialization
Dot11ExtSetUnicastCipherAlgorithm	Adapter Initialization

For more information about IHV Handler functions, see Native 802.11 IHV Handler Functions.

See Also

Reference

Native 802.11 IHV Extensions DLL
DOT11EXT_APIS
Dot11ExtIhvInitService
Dot11ExtIhvDeinitService
Dot11ExtIhvAdapterReset
Dot11ExtIhvDeinitAdapter
Dot11ExtIhvPerformPreAssociate
Dot11ExtIhvPerformPostAssociate
Native 802.11 IHV Handler Functions
Native 802.11 Extensible Station Status Indications
Native 802.11 Wireless LAN Status Indications