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)