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

Статья
08/08/2023

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

Операционная система вызывает функцию DLL-библиотеки расширений IHV Dot11ExtIhvControl , чтобы разрешить независимому поставщику оборудования (IHV) управление драйверами или службами WLAN.

Синтаксис

DOT11EXTIHV_CONTROL Dot11extihvControl;

DWORD Dot11extihvControl(
  [in, optional]  HANDLE hIhvExtAdapter,
  [in]            DWORD dwInBufferSize,
  [in, optional]  PBYTE pInBuffer,
  [in]            DWORD dwOutBufferSize,
  [out, optional] PBYTE pOutBuffer,
  [out]           PDWORD pdwBytesReturned
)
{...}

Параметры

[in, optional] hIhvExtAdapter

Дескриптор, используемый библиотекой DLL расширений IHV для ссылки на адаптер WLAN. Это значение дескриптора было указано при предыдущем вызове функции IHV Handler Dot11ExtIhvInitAdapter .

[in] dwInBufferSize

Размер (в байтах) входного буфера управления, на который указывает параметр pInBuffer .

[in, optional] pInBuffer

Указатель на буфер элемента управления входами.

[in] dwOutBufferSize

Размер выходного буфера (если он указан) в байтах, на который указывает параметр pOutBuffer .

[out, optional] pOutBuffer

Указатель на выходной буфер, если он указан.

[out] pdwBytesReturned

Указатель на переменную, содержащую размер (в байтах) буфера входных и выходных данных ответа.

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

Если вызов завершается успешно, функция возвращает ERROR_SUCCESS. В противном случае возвращается код ошибки, определенный в Winerror.h.

Операционная система вызывает эту функцию при вызове функции WlanIhvControl с параметром Type , равным wlan_ihv_control_type_service. Описание функции WlanIhvControl см. в документации по Microsoft Windows SDK.

Данные, передаваемые с помощью этой функции, не проверяются, поэтому IHV отвечает за правильный анализ входного буфера.

Буфер данных, на который указывает параметр pdwBytesReturned , всегда возвращается. Однако буфер, на который указывает pOutBuffer , будет скопирован только в том случае, если указан допустимый указатель и значение, на которое указывает pdwBytesReturned , меньше или равно dwOutBufferSize .

Требования

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

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

Dot11ExtIhvInitAdapter