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

Статья
08/08/2023

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

Операционная система вызывает функцию Dot11ExtIhvInitService для инициализации библиотеки DLL расширений IHV, а также интерфейса API между операционной системой и библиотекой DLL.

Синтаксис

DOT11EXTIHV_INIT_SERVICE Dot11extihvInitService;

DWORD Dot11extihvInitService(
  [in]  DWORD dwVerNumUsed,
  [in]  PDOT11EXT_APIS pDot11ExtAPI,
        LPVOID pvReserved,
  [out] PDOT11EXT_IHV_HANDLERS pDot11IHVHandlers
)
{...}

Параметры

[in] dwVerNumUsed

Версия интерфейса, используемая операционной системой. Значение этого параметра должно находиться между диапазонами номеров версий, возвращаемых в параметре pDot11IHVVersionInfo объекта Dot11ExtIhvGetVersionInfo Функция обработчика IHV.

[in] pDot11ExtAPI

Указатель на структуру DOT11EXT_APIS , которая содержит адреса функций расширяемости IHV, поддерживаемых операционной системой. Операционная система форматирует этот параметр адресами функций перед вызовом функции Dot11ExtIhvInitService .

pvReserved

Этот параметр зарезервирован для использования операционной системой.

[out] pDot11IHVHandlers

Указатель на структуру DOT11EXT_IHV_HANDLERS , которая содержит адреса функций обработчика IHV, поддерживаемых библиотекой DLL расширений IHV. Библиотека DLL форматирует этот параметр адресами функции перед возвратом из вызова функции Dot11ExtIhvInitService .

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

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

Операционная система вызывает функцию Dot11ExtIhvInitService сразу после вызова Функция Dot11ExtIhvGetVersionInfo . При вызове Dot11ExtIhvInitService должна инициализировать библиотеку DLL расширений IHV. Когда функция возвращается, библиотека DLL должна быть подготовлена к приему дополнительных вызовов функции обработчика IHV.

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

Библиотека DLL должна реализовывать функцию с именем Dot11ExtIhvInitService, которая имеет формат, описанный в этом разделе.
Инструкция EXPORTS файла определения исходного модуля (DEF), который используется для сборки библиотеки DLL расширений IHV, должна содержать запись имени функции для функции Dot11ExtIhvInitService .

Дополнительные сведения о GetProcAddress см. в документации по Microsoft Windows SDK.

Требования

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

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

DOT11EXT_APIS

DOT11EXT_IHV_HANDLERS

Dot11ExtIhvGetVersionInfo