DOT11EXTIHV_INIT_ADAPTER回调函数 (wlanihv.h)

重要本机 802.11 无线 LAN 接口在 Windows 10 及更高版本中已弃用。 请改用 WLAN 设备驱动程序接口 (WDI) 。 有关 WDI 的详细信息,请参阅 WLAN 通用 Windows 驱动程序模型
 
操作系统调用 Dot11ExtIhvInitAdapter 函数,让 IHV 扩展 DLL 分配并初始化适配器上下文。

语法

DOT11EXTIHV_INIT_ADAPTER Dot11extihvInitAdapter;

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

参数

[in] pDot11Adapter

指向 DOT11_ADAPTER 结构的指针,该结构标识要初始化的适配器。

[in, optional] hDot11SvcHandle

由操作系统为适配器分配的句柄。 IHV 扩展 DLL 在调用声明 hDot11SvcHandle 参数的任何 IHV 扩展性函数时,必须使用此句柄值,例如 Dot11ExtPreAssociateCompletion

[out] phIhvExtAdapter

指向句柄变量的指针。 IHV 扩展 DLL 必须为适配器分配唯一的句柄值,并将 * phIhvExtAdapter 设置为句柄值。 操作系统在调用声明 hIhvExtAdapter 参数的任何 IHV 处理程序函数时使用此句柄值,例如 Dot11ExtIhvPerformPreAssociate

通常,IHV 扩展 DLL 为适配器上下文分配状态数组,并将数组的地址作为句柄值返回。

返回值

如果调用成功,函数将返回ERROR_SUCCESS。 否则,它将返回 Winerror.h 中定义的错误代码。

注解

每当 WLAN 适配器可用并启用使用时(例如插入 PCMCIA 适配器时),操作系统将调用 Dot11ExtIhvInitAdapter 函数。

有关 WLAN 适配器初始化的详细信息,请参阅 802.11 WLAN 适配器到达

要求

要求
最低受支持的客户端 在 Windows Vista 和更高版本的 Windows 操作系统中可用。
目标平台 桌面
标头 wlanihv.h (包括 Wlanihv.h)

另请参阅

本机 802.11 IHV 可扩展性函数

Dot11ExtPreAssociateCompletion Dot11ExtIhvPerformPreAssociate

DOT11_ADAPTER