本机 802.11 IHV 扩展性函数

重要

本机 802.11 无线 LAN 接口在 Windows 10 及更高版本中已弃用。 请改用 WLAN 设备驱动程序接口 (WDI) 。 有关 WDI 的详细信息,请参阅 WLAN 通用 Windows 驱动程序模型

本机 802.11 IHV 扩展性函数由操作系统提供,并由 IHV 扩展 DLL 调用以执行以下操作:

  • 分配和释放本机 802.11 框架中使用的缓冲区。
  • 通过 IHV 的无线 LAN (WLAN) 适配器发送数据包,例如身份验证算法定义的数据包。
  • 使用各种安全设置为 IHV 扩展 DLL 支持的任何身份验证和密码算法配置 IHV 的 WLAN 适配器。
  • 如果安装了 IHV UI 扩展 DLL (接口,) 处理事件通知。 例如,IHV 扩展 DLL 可以通知 IHV UI 扩展 DLL 有关基本服务集 (BSS) 网络连接所涉及的各个阶段。

有关 IHV UI 扩展 DLL 的详细信息,请参阅 Native 802.11 IHV UI Extensions DLL

注意

IHV 扩展 DLL 通过与 DOT11EXT_APIS 结构的成员关联的函数指针调用每个 Native 802.11 IHV 扩展性函数。 当操作系统调用 Dot11ExtIhvInitService IHV 处理程序函数时,它会通过 pDot11ExtAPI 参数将指针列表传递到 IHV 扩展性函数。

下表列出了可由 IHV 扩展 DLL 调用的本机 802.11 IHV 扩展函数。 每个 IHV 扩展性函数只能在这些条件下调用。

  • 服务初始化后调用
    只有在调用 Dot11ExtIhvInitService IHV 处理程序函数以初始化 IHV 扩展 DLL 之后,才能调用 IHV 扩展函数。 此外,在调用 Dot11ExtIhvDeinitService IHV 处理程序函数后,扩展 DLL 无法调用 IHV 扩展性函数。
  • 适配器初始化后调用
    只有在调用 Dot11ExtIhvInitAdapter IHV 处理程序函数以初始化 IHV WLAN 适配器的接口之后,才能调用 IHV 扩展性函数。
    IHV 扩展性函数需要一个用于标识 WLAN 适配器的句柄。 调用 Dot11ExtIhvInitAdapter 时,IHV 扩展 DLL 将通过 hDot11SvcHandle 参数传递此句柄。
    在调用 Dot11ExtIhvDeinitAdapter IHV 处理程序函数后,扩展 DLL 无法调用 IHV 扩展性函数。
  • 在预关联后调用
    只有在调用 Dot11ExtIhvPerformPreAssociate IHV 处理程序函数以使用 BSS) 网络的基本服务集启动预关联操作之后 (,才能调用 IHV 扩展性函数。
    IHV 扩展性函数需要一个句柄,用于标识 BSS 网络连接。 调用 Dot11ExtIhvPerformPreAssociate 时,IHV 扩展 DLL 将通过 hConnection 参数传递此句柄。
    在调用 Dot11ExtIhvDeinitAdapterDot11ExtIhvAdapterReset IHV 处理程序函数后,扩展 DLL 无法调用 IHV 扩展性函数。
  • 在关联后调用
    只有在调用 Dot11ExtIhvPerformPostAssociate IHV 处理程序函数以使用 BSS) 网络的基本服务集启动关联后操作之后 (,才能调用 IHV 扩展性函数。
    IHV 扩展性函数需要句柄,该句柄标识具有 BSS 网络连接的安全会话。 调用 Dot11ExtIhvPerformPostAssociate 时,IHV 扩展 DLL 将通过 hSecuritySessionID 参数传递此句柄。
    在调用 Dot11ExtIhvDeinitAdapterDot11ExtIhvAdapterReset IHV 处理程序函数后,扩展 DLL 无法调用 IHV 扩展性函数。
函数 在服务初始化后调用 适配器初始化后调用 在预关联后调用 在关联后调用
Dot11ExtAllocateBuffer X
Dot11ExtFreeBuffer X
Dot11ExtGetProfileCustomUserData X
Dot11ExtNicSpecificExtension X
Dot11ExtStartOneX X
Dot11ExtStopOneX X
Dot11ExtPostAssociateCompletion X
Dot11ExtPreAssociateCompletion X
Dot11ExtProcessOneXPacket X
Dot11ExtQueryVirtualStationProperties X
Dot11ExtReleaseVirtualStation X
Dot11ExtRequestVirtualStation X
Dot11ExtSendNotification X
Dot11ExtSendUIRequest X
Dot11ExtSetAuthAlgorithm X
Dot11ExtSetCurrentProfile X
Dot11ExtSetDefaultKey X
Dot11ExtSetDefaultKeyId X
Dot11ExtSetEtherTypeHandling X
Dot11ExtSetExcludeUnencrypted X
Dot11ExtSetKeyMappingKey X
Dot11ExtSetMulticastCipherAlgorithm X
Dot11ExtSetProfileCustomUserData X
Dot11ExtSetUnicastCipherAlgorithm X
Dot11ExtSetVirtualStationAPProperties X

有关 IHV 处理程序函数的详细信息,请参阅 本机 802.11 IHV 处理程序函数