DOT11EXTIHV_INIT_SERVICE回调函数 (wlanihv.h)

重要本机 802.11 无线 LAN 接口在 Windows 10 及更高版本中已弃用。 请改用 WLAN 设备驱动程序接口 (WDI) 。 有关 WDI 的详细信息,请参阅 WLAN 通用 Windows 驱动程序模型
 
操作系统调用 Dot11ExtIhvInitService 函数来初始化 IHV 扩展 DLL 以及操作系统和 DLL 之间的 API 接口。

语法

DOT11EXTIHV_INIT_SERVICE Dot11extihvInitService;

DWORD Dot11extihvInitService(
  [in]  DWORD dwVerNumUsed,
  [in]  PDOT11EXT_APIS pDot11ExtAPI,
        LPVOID pvReserved,
  [out] PDOT11EXT_IHV_HANDLERS pDot11IHVHandlers
)
{...}

参数

[in] dwVerNumUsed

操作系统使用的接口版本。 此参数的值必须介于 的 pDot11IHVVersionInfo 参数中返回的版本号范围之间 Dot11ExtIhvGetVersionInfo IHV 处理程序函数。

[in] pDot11ExtAPI

指向 DOT11EXT_APIS 结构的指针,该结构包含操作系统支持的 IHV 扩展性函数的地址。 在调用 Dot11ExtIhvInitService 函数之前,操作系统使用函数地址设置此参数的格式。

pvReserved

此参数保留供操作系统使用。

[out] pDot11IHVHandlers

指向 DOT11EXT_IHV_HANDLERS 结构的指针,该结构包含 IHV 扩展 DLL 支持的 IHV 处理程序函数的地址。 DLL 在从 Dot11ExtIhvInitService 函数的调用返回之前,使用函数地址设置此参数的格式。

返回值

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

注解

操作系统在调用 后立即调用 Dot11ExtIhvInitService 函数 Dot11ExtIhvGetVersionInfo 函数。 调用 Dot11ExtIhvInitService 时,必须根据需要初始化 IHV 扩展 DLL。 当函数返回时,DLL 必须准备好接受对 IHV 处理程序函数的其他调用。

与处理通过 pDot11IHVHandlers 参数解析地址的其他 IHV 扩展和处理程序函数的方式不同,操作系统通过调用 GetProcAddress 函数解析 Dot11ExtIhvInitService 函数的地址。 因此,IHV 扩展 DLL 的开发人员必须遵循这些准则。

  • DLL 必须实现名为 Dot11ExtIhvInitService 的函数,该函数采用本主题中所述的格式。
  • 用于生成 IHV 扩展 DLL 的源模块定义 (.def) 文件的 EXPORTS 语句必须包含 Dot11ExtIhvInitService 函数的函数名称条目。
有关 GetProcAddress 的详细信息,请参阅Microsoft Windows SDK文档。

要求

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

另请参阅

DOT11EXT_APIS

DOT11EXT_IHV_HANDLERS

Dot11ExtIhvGetVersionInfo