Dot11ExtIhvInitAdapter routine

The operating system calls the Dot11ExtIhvInitAdapter function to have the IHV Extensions DLL allocate and initialize an adapter context.

Syntax


DOT11EXTIHV_INIT_ADAPTER Dot11ExtIhvInitAdapter;

DWORD APIENTRY Dot11ExtIhvInitAdapter(
  _In_     PDOT11_ADAPTER pDot11Adapter,
  _In_opt_ HANDLE         hDot11SvcHandle,
  _Out_    PHANDLE        phIhvExtAdapter
)
{ ... }

Parameters

pDot11Adapter [in]

A pointer to a DOT11_ADAPTER structure, which identifies the adapter to be initialized.

hDot11SvcHandle [in, optional]

A handle assigned by the operating system for the adapter. The IHV Extensions DLL must use this handle value when calling any IHV Extensibility function that declares an hDot11SvcHandle parameter, such as Dot11ExtPreAssociateCompletion.

phIhvExtAdapter [out]

A pointer to a handle variable. The IHV Extensions DLL must assign a unique handle value for the adapter and set * phIhvExtAdapter to the handle value. The operating system uses this handle value when it calls any IHV Handler function that declares an hIhvExtAdapter parameter, such as Dot11ExtIhvPerformPreAssociate.

Typically, the IHV Extensions DLL allocates a state array for the adapter context and returns the address of the array as the handle value.

Return value

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

Remarks

The operating system calls the Dot11ExtIhvInitAdapter function whenever a WLAN adapter becomes available and enabled for use, such as when a PCMCIA adapter is inserted.

For more information about WLAN adapter initialization, see 802.11 WLAN Adapter Arrival.

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_ADAPTER
Dot11ExtPreAssociateCompletion
Dot11ExtIhvPerformPreAssociate
Native 802.11 IHV Extensibility Functions

 

 

Send comments about this topic to Microsoft

Show:
© 2015 Microsoft