Share via


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