DOT11EXTIHV_INIT_SERVICE回调函数 (wlanihv.h)

重要 Windows 10 及更高版本中弃用了 Native 802.11 无线 LAN 接口。 请改用 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