DOT11EXT_SET_ETHERTYPE_HANDLING回调函数 (wlanihv.h)

项目
02/27/2024

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

IHV 扩展 DLL 调用 Dot11ExtSetEtherTypeHandling 函数执行以下操作：

使用数据包解密豁免列表配置无线 LAN (WLAN) 适配器。每个豁免都基于接收的数据包的 IEEE EtherType 应用。
向操作系统注册接收的数据包的 EtherType，这些数据包将通过调用 Dot11ExtIhvReceivePacket IHV 处理程序函数转发到 IHV 扩展 DLL。

语法

DOT11EXT_SET_ETHERTYPE_HANDLING Dot11extSetEthertypeHandling;

DWORD Dot11extSetEthertypeHandling(
  [in, optional] HANDLE hDot11SvcHandle,
  [in]           ULONG uMaxBackLog,
  [in]           ULONG uNumOfExemption,
  [in, optional] PDOT11_PRIVACY_EXEMPTION pExemption,
  [in]           ULONG uNumOfRegistration,
  [in, optional] USHORT *pusRegistration
)
{...}

参数

[in, optional] hDot11SvcHandle

操作系统用于引用 WLAN 适配器的句柄。此句柄值是通过先前对 Dot11ExtIhvInitAdapter IHV 处理程序函数的调用指定的。

[in] uMaxBackLog

如果 IHV 扩展 DLL 未从对 Dot11ExtIhvReceivePacket IHV 处理程序函数的调用返回，则操作系统排队的最大接收数据包数。到达 uMaxBackLog 时，操作系统会丢弃队列中最早的数据包。

[in] uNumOfExemption

pExemption 参数引用的隐私豁免数组中的条目数。值为零会禁用 WLAN 适配器上的隐私豁免。

[in, optional] pExemption

指向隐私豁免数组的指针。数组中的每个条目都格式化为 DOT11_PRIVACY_EXEMPTION 结构。

[in] uNumOfRegistration

pusRegistration 参数引用的 IEEE EtherType 注册数组中的条目数。值为零会禁用 IHV 扩展 DLL 通过调用 Dot11ExtIhvReceivePacket IHV 处理程序函数接收任何数据包的能力。

[in, optional] pusRegistration

指向 IEEE EtherType 注册数组的指针。每个条目都有 big-endian 格式的 EtherType 值。

返回值

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

注解

调用 Dot11ExtSetEtherTypeHandling 函数时，IHV 扩展 DLL 必须遵循以下准则：

IHV 扩展 DLL 可以从对 Dot11ExtIhvInitAdapter 或的调用中调用 Dot11ExtSetEtherTypeHandling Dot11ExtIhvPerformPreAssociate IHV 处理程序函数。
通过调用成功完成预关联操作后，IHV 扩展 DLL 不得调用 Dot11ExtSetEtherTypeHandling Dot11ExtPreAssociateCompletion。

在调用 Dot11ExtIhvInitAdapter IHV 处理程序函数之前，操作系统默认为隐私豁免和 EtherType 注册的空列表。

要求

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