Поделиться через

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

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

Синтаксис

DOT11EXTIHV_INIT_ADAPTER Dot11extihvInitAdapter;

DWORD Dot11extihvInitAdapter(
  [in]           PDOT11_ADAPTER pDot11Adapter,
  [in, optional] HANDLE hDot11SvcHandle,
  [out]          PHANDLE phIhvExtAdapter
)
{...}

Параметры

[in] pDot11Adapter

Указатель на структуру DOT11_ADAPTER , которая определяет инициализируемый адаптер.

[in, optional] hDot11SvcHandle

Дескриптор, назначенный операционной системой для адаптера. Библиотека DLL расширений IHV должна использовать это значение дескриптора при вызове любой функции расширяемости IHV, которая объявляет параметр hDot11SvcHandle , например Dot11ExtPreAssociateCompletion.

[out] phIhvExtAdapter

Указатель на переменную дескриптора. Библиотека DLL расширений IHV должна назначить уникальное значение дескриптора для адаптера и задать значение дескриптора * phIhvExtAdapter . Операционная система использует это значение дескриптора при вызове любой функции обработчика IHV, которая объявляет параметр hIhvExtAdapter , например Dot11ExtIhvPerformPreAssociate.

Как правило, библиотека DLL расширений IHV выделяет массив состояний для контекста адаптера и возвращает адрес массива в качестве значения дескриптора.

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

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

Комментарии

Операционная система вызывает функцию Dot11ExtIhvInitAdapter всякий раз, когда адаптер WLAN становится доступным и включен для использования, например при вставке адаптера PCMCIA.

Дополнительные сведения об инициализации адаптера WLAN см. в разделе 802.11 Получение адаптера WLAN.

Требования

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

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

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

Dot11ExtPreAssociateCompletion Dot11ExtIhvPerformPreAssociate

DOT11_ADAPTER