DOT11EXT_ALLOCATE_BUFFER回调函数（wlanihv.h）

重要 Windows 10 及更高版本中弃用了 Native 802.11 无线 LAN 接口。请改用 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 处理程序函数的详细信息，请参阅 Native 802.11 IHV 处理程序函数。
IHV 扩展 DLL 可能会调用此函数来分配 DLL 本身引用的内存。
在这种情况下，DLL 必须通过调用 Dot11ExtFreeBuffer来释放内存缓冲区。

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