DOT11EXT_NIC_SPECIFIC_EXTENSION回调函数 (wlanihv.h)

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

IHV 扩展 DLL 调用 Dot11ExtNicSpecificExtension 函数，以向本机 802.11 微型端口驱动程序发出专有的 NDIS 6.0 方法请求，该驱动程序管理无线 LAN (WLAN) 适配器。

语法

DOT11EXT_NIC_SPECIFIC_EXTENSION Dot11extNicSpecificExtension;

DWORD Dot11extNicSpecificExtension(
  [in, optional] HANDLE hDot11SvcHandle,
  [in]           DWORD dwInBufferSize,
  [in]           LPVOID pvInBuffer,
  [in, out]      DWORD *pdwOutBufferSize,
  [out]          LPVOID pvOutBuffer
)
{...}

参数

[in, optional] hDot11SvcHandle

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

[in] dwInBufferSize

pvInBuffer 参数引用的调用方分配的数据缓冲区的大小（以字节为单位）。

[in] pvInBuffer

指向调用方分配的输入缓冲区的指针，该缓冲区包含执行操作所需的数据。 此数据的格式由 IHV 定义。

[in, out] pdwOutBufferSize

指向调用方分配的 DWORD 变量的指针。 调用 Dot11ExtNicSpecificExtension 函数时，IHV 扩展 DLL 必须将此变量设置为 pvOutBuffer 参数引用的调用方分配的数据缓冲区的大小（以字节为单位）。 函数返回时，操作系统会将变量设置为 pvOutBuffer 参数引用的数据缓冲区中返回的实际字节数。

[out] pvOutBuffer

指向调用方分配的缓冲区的指针，该缓冲区包含从本机 802.11 微型端口驱动程序为指定请求返回的数据。 此数据的格式由 IHV 定义。 如果本机 802.11 微型端口驱动程序不返回数据，此参数可以为 NULL 。

返回值

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

注解

Dot11ExtNicSpecificExtension 函数允许 IHV 扩展 DLL 将专有方法请求传递给由 hDot11SvcHandle 参数引用的 Native 802.11 微型端口驱动程序。 操作系统通过 Native 802.11 发出方法请求 OID_DOT11_NIC_SPECIFIC_EXTENSION 对象标识符 (OID) 。

注意 OID_DOT11_NIC_SPECIFIC_EXTENSION是本机 802.11 微型端口驱动程序支持的可选 OID。 如果驱动程序不支持此 OID，Dot11ExtNicSpecificExtension 将返回值 ERROR_NOT_SUPPORTED。

要求

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

另请参阅

OID_DOT11_NIC_SPECIFIC_EXTENSION

Dot11ExtIhvInitAdapter