Dot11ExtIhvInitAdapter (Compact 7)

3/12/2014

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

Syntax

DWORD WINAPI Dot11ExtIhvInitAdapter(
  PDOT11_ADAPTER pDot11Adapter,
  HANDLE hDot11SvcHandle,
  PHANDLE phIhvExtAdapter
);

pDotAdapter
[in] A pointer to a DOT11_ADAPTER structure, which identifies the adapter to be initialized.

hDot11SvcHandle
[in] A handle assigned by the operating system for the adapter. The IHV Extensions DLL must use this handle value when it calls 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.

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

The operating system calls the Dot11ExtIhvInitAdapter function when a WLAN adapter becomes available and enabled for use.

Header

wlanihv.h