функция обратного вызова DOT11EXT_ALLOCATE_BUFFER (wlanihv.h)

Статья
08/08/2023

ВажноСобственный интерфейс беспроводной локальной сети 802.11 не рекомендуется использовать в Windows 10 и более поздних версиях. Вместо этого используйте интерфейс WLAN Device Driver Interface (WDI). Дополнительные сведения о WDI см. в статье Модель универсального драйвера WLAN для Windows.

Библиотека DLL расширений IHV вызывает функцию Dot11ExtAllocateBuffer для выделения памяти для буферов переменной длины.

Синтаксис

DOT11EXT_ALLOCATE_BUFFER Dot11extAllocateBuffer;

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

Параметры

[in] dwByteCount

Размер выделенного буфера в байтах.

[out] ppvBuffer

Указатель на переменную, предоставленную вызывающим объектом, в котором хранится адрес выделенного буфера. Параметр ppvBuffer имеет допустимое значение, отличное от NULL, если возвращаемое значение ERROR_SUCCESS.

Возвращаемое значение

Вызов возвращает код ERROR_xxxx, определенный в Winerror.h. Следующие коды ERROR_xxxx обычно возвращаются функцией Dot11ExtAllocateBuffer .

Код возврата	Описание
ERROR_SUCCESS	Вызов выполнен без ошибок.
ERROR_OUTOFMEMORY	Операционной системе не удалось выделить память из-за нехватки ресурсов.

Библиотека DLL расширений IHV должна вызывать эту функцию при возврате буфера переменной длины из функции обработчика IHV. В этом случае операционная система отвечает за освобождение буфера после возврата функции обработчика IHV.
Дополнительные сведения о функциях обработчика IHV см. в статье Собственные функции обработчика IHV 802.11.
Библиотека DLL расширений IHV может вызывать эту функцию для выделения памяти, на которую ссылается сама библиотека DLL.
В этом случае библиотека DLL должна освободить буфер памяти, вызвав Метод Dot11ExtFreeBuffer.

Требования

Требование	Значение
Минимальная версия клиента	Доступно в Windows Vista и более поздних версиях операционных систем Windows.
Целевая платформа	Персональный компьютер
Верхняя часть	wlanihv.h (включая Wlanihv.h)

См. также раздел

Собственные функции обработчика IHV 802.11

Dot11ExtIhvCreateDiscoveryProfiles

Dot11ExtFreeBuffer