DOT11EXT_ALLOCATE_BUFFER回调函数 (wlanihv.h)

  • 项目
重要本机 802.11 无线 LAN 接口在 Windows 10 及更高版本中已弃用。 请改用 WLAN 设备驱动程序接口 (WDI) 。 有关 WDI 的详细信息，请参阅 WLAN 通用 Windows 驱动程序模型。
 
IHV 扩展 DLL 调用 Dot11ExtAllocateBuffer 函数为可变长度缓冲区分配内存。

语法

DOT11EXT_ALLOCATE_BUFFER Dot11extAllocateBuffer;

DWORD Dot11extAllocateBuffer(
  [in]  DWORD dwByteCount,
  [out] LPVOID *ppvBuffer
)
{...}

参数

[in] dwByteCount

要分配的缓冲区的大小（以字节为单位）。

[out] ppvBuffer

指向调用方提供的变量的指针，该变量存储分配的缓冲区的地址。 如果返回值ERROR_SUCCESS， 则 ppvBuffer 参数具有有效的非 null 值。

返回值

调用返回 Winerror.h 中定义的ERROR_xxxx代码。 以下ERROR_xxxx代码通常由 Dot11ExtAllocateBuffer 函数返回。

返回代码 说明
ERROR_SUCCESS
 调用成功，但未出错。
ERROR_OUTOFMEMORY
 由于缺少资源，操作系统无法分配内存。

注解

调用 Dot11ExtAllocateBuffer 函数时，IHV 扩展 DLL 必须遵循这些准则。

  • 从 IHV 处理程序函数返回任何长度可变的缓冲区时，IHV 扩展 DLL 必须调用此函数。 在这种情况下，操作系统负责在返回 IHV 处理程序函数后释放缓冲区。

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

  • IHV 扩展 DLL 可能会调用此函数来分配 DLL 本身引用的内存。

    在这种情况下，DLL 必须通过调用 Dot11ExtFreeBuffer 来释放内存缓冲区。

要求

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

另请参阅

本机 802.11 IHV 处理程序函数

Dot11ExtIhvCreateDiscoveryProfiles

Dot11ExtFreeBuffer