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

Статья
08/08/2023

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

Библиотека DLL расширений IHV вызывает функцию Dot11ExtSetEtherTypeHandling для выполнения следующих действий:

Настройте адаптер беспроводной локальной сети (WLAN) со списком исключений для расшифровки пакетов. Каждое исключение применяется на основе ieee EtherType полученного пакета.
Зарегистрируйтесь в операционной системе для EtherTypes полученных пакетов, которые будут пересылаться в библиотеку DLL расширений IHV через вызовы функции IHV Handler Dot11ExtIhvReceivePacket .

Синтаксис

DOT11EXT_SET_ETHERTYPE_HANDLING Dot11extSetEthertypeHandling;

DWORD Dot11extSetEthertypeHandling(
  [in, optional] HANDLE hDot11SvcHandle,
  [in]           ULONG uMaxBackLog,
  [in]           ULONG uNumOfExemption,
  [in, optional] PDOT11_PRIVACY_EXEMPTION pExemption,
  [in]           ULONG uNumOfRegistration,
  [in, optional] USHORT *pusRegistration
)
{...}

Параметры

[in, optional] hDot11SvcHandle

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

[in] uMaxBackLog

Максимальное число полученных пакетов, которое операционная система помещает в очередь, если библиотека DLL расширений IHV не вернула из вызова функции IHV Handler Dot11ExtIhvReceivePacket . По достижении uMaxBackLog операционная система удаляет самый старый пакет в очереди.

[in] uNumOfExemption

Количество записей в массиве исключений конфиденциальности, на которые ссылается параметр pExemption . Нулевое значение отключает исключения конфиденциальности в адаптере WLAN.

[in, optional] pExemption

Указатель на массив исключений конфиденциальности. Каждая запись в массиве отформатирована как DOT11_PRIVACY_EXEMPTION структура.

[in] uNumOfRegistration

Число записей в массиве регистраций IEEE EtherType, на которые ссылается параметр pusRegistration . Нулевое значение отключает возможность библиотеки DLL расширений IHV получать любые пакеты через вызовы функции IHV Handler Dot11ExtIhvReceivePacket .

[in, optional] pusRegistration

Указатель на массив регистраций IEEE EtherType. Каждая запись имеет значение EtherType в формате big-endian.

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

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

Библиотека DLL расширений IHV может вызывать Dot11ExtSetEtherTypeHandling из вызовов Dot11ExtIhvInitAdapter или Dot11ExtIhvPerformPreAssociate Функции обработчика IHV.
Библиотека DLL расширений IHV не должна вызывать Dot11ExtSetEtherTypeHandling после успешного завершения операции предварительной связи с помощью вызова Dot11ExtPreAssociateCompletion.

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

Требования

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