DOT11EXTIHV_INIT_ADAPTER callback function (wlanihv.h)

Syntax

DOT11EXTIHV_INIT_ADAPTER Dot11extihvInitAdapter;

DWORD Dot11extihvInitAdapter(
  [in]           PDOT11_ADAPTER pDot11Adapter,
  [in, optional] HANDLE hDot11SvcHandle,
  [out]          PHANDLE phIhvExtAdapter
)
{...}

Parameters

[in] pDot11Adapter

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

[in, optional] hDot11SvcHandle

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.

[out] phIhvExtAdapter

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

See also

Native 802.11 IHV Extensibility Functions

DOT11_ADAPTER