Нативные функции расширяемости IHV 802.11
Важный
Интерфейс беспроводной локальной сети Native 802.11 устарел в Windows 10 и более поздних версиях. Вместо этого используйте интерфейс драйвера устройств WLAN (WDI). Дополнительные сведения о WDI см. в универсальной модели драйвера WLAN для Windows.
Функции нативной расширяемости IHV 802.11 предоставляются операционной системой и вызываются библиотекой расширений DLL IHV, чтобы выполнить следующие действия:
- Выделить и освободить буферы, используемые в платформе Native 802.11.
- Отправка пакетов, таких как пакет, определенный алгоритмом проверки подлинности, через адаптер беспроводной локальной сети (WLAN) IHV.
- Настройте адаптер WLAN IHV с различными параметрами безопасности для любых алгоритмов проверки подлинности и шифров, поддерживаемых библиотекой DLL расширений IHV.
- Интерфейс с библиотекой DLL расширений пользовательского интерфейса IHV (если она установлена) для обработки уведомлений о событиях. Например, библиотека DLL расширений IHV может уведомить библиотеку DLL расширений пользовательского интерфейса IHV о различных этапах, участвующих в сетевом подключении базового набора служб (BSS).
Дополнительные сведения о библиотеке DLL расширений пользовательского интерфейса IHV см. в разделе Native 802.11 IHV UI Extensions DLL.
Заметка
Библиотека DLL расширений IHV вызывает каждую функцию расширения нативных 802.11 IHV через указатель функции, ассоциированный с элементом структуры DOT11EXT_APIS. Когда операционная система вызывает функцию обработчика Dot11ExtIhvInitService IHV Handler, она передает список указателей функциям расширяемости IHV через параметр pDot11ExtAPI.
В следующей таблице перечислены нативные функции расширяемости IHV 802.11, которые могут вызываться библиотекой расширений DLL IHV. Каждая функция расширяемости IHV может вызываться только при выполнении следующих условий.
-
вызывается после инициализации службы
Функция расширяемости IHV может вызываться только после вызова функции Dot11ExtIhvInitService функции обработчика IHV для инициализации библиотеки DLL расширений IHV. Кроме того, библиотека DLL расширений не может вызывать функцию расширяемости IHV после вызова функции Dot11ExtIhvDeinitService обработчика IHV. -
Вызывается после инициализации адаптера
Функция расширяемости IHV может вызываться только после того, как была вызвана функция обработчика Dot11ExtIhvInitAdapter для инициализации интерфейса с адаптером WLAN IHV.
Для функции расширяемости IHV требуется идентификатор, определяющий адаптер WLAN. Когда вызывается Dot11ExtIhvInitAdapter, этому DLL расширений IHV передается дескриптор через параметр hDot11SvcHandle.
Библиотека DLL расширений не может вызывать функцию расширяемости IHV после вызова функции обработчика IHV Dot11ExtIhvDeinitAdapter. -
активируется после предварительной связи
Функция расширяемости IHV может вызываться только после вызова функции обработчика Dot11ExtIhvPerformPreAssociate для запуска операции предварительной ассоциации с базовой сетью обслуживания (BSS).
Для функции расширяемости IHV требуется дескриптор, определяющий сетевое подключение BSS. Когда вызывается Dot11ExtIhvPerformPreAssociate, дескриптор передается библиотеке DLL расширений IHV через параметр hConnection.
Библиотека расширений DLL не может вызывать функцию расширяемости IHV после того как были вызваны функции обработчика Dot11ExtIhvDeinitAdapter или Dot11ExtIhvAdapterReset. -
вызывается после ассоциации
Функция расширяемости IHV может вызываться только после вызова функции Dot11ExtIhvPerformPostAssociate обработчика IHV для запуска операции после ассоциации с сетью BSS.
Функция расширяемости IHV требует дескриптора, который определяет сеанс безопасности с сетевым подключением BSS. Когда вызывается Dot11ExtIhvPerformPostAssociate, библиотека DLL расширений IHV передается через параметр hSecuritySessionID.
Библиотека расширений DLL не может вызывать функцию расширения IHV после вызова функций обработчика IHV Dot11ExtIhvDeinitAdapter или Dot11ExtIhvAdapterReset.
| Функция | Вызывается после инициализации службы | Вызывается после инициализации адаптера | Вызывается после предварительной связи | Вызывается после ассоциации |
|---|---|---|---|---|
| Dot11ExtAllocateBuffer | X | |||
| Dot11ExtFreeBuffer | X | |||
| Dot11ExtGetProfileCustomUserData | X | |||
| Dot11ExtNicSpecificExtension | X | |||
| Dot11ExtStartOneX | X | |||
| Dot11ExtStopOneX | X | |||
| Dot11ExtPostAssociateCompletion | X | |||
| Dot11ExtPreAssociateCompletion | X | |||
| Dot11ExtProcessOneXPacket | X | |||
| Dot11ExtQueryVirtualStationProperties | X | |||
| Dot11ExtReleaseVirtualStation | X | |||
| Dot11ExtRequestVirtualStation | X | |||
| Dot11ExtSendNotification | X | |||
| Dot11ExtSendUIRequest | X | |||
| Dot11ExtSetAuthAlgorithm | X | |||
| Dot11ExtSetCurrentProfile | X | |||
| Dot11ExtSetDefaultKey | X | |||
| Dot11ExtSetDefaultKeyId | X | |||
| Dot11ExtSetEtherTypeHandling | X | |||
| Dot11ExtSetExcludeUnencrypted | X | |||
| Dot11ExtSetKeyMappingKey | X | |||
| Dot11ExtSetMulticastCipherAlgorithm | X | |||
| Dot11ExtSetProfileCustomUserData | X | |||
| Dot11ExtSetUnicastCipherAlgorithm | X | |||
| Dot11ExtSetVirtualStationAPProperties | X |
Дополнительную информацию о функциях обработчика IHV см. в разделе Native 802.11 Функции обработчика IHV.