Native 802.11 IHV-Erweiterbarkeitsfunktionen
Wichtig
Die Native 802.11 Wireless LAN-Schnittstelle ist in Windows 10 und höher veraltet. Verwenden Sie stattdessen die WLAN Device Driver Interface (WDI). Weitere Informationen zu WDI finden Sie unter Wlan Universal Windows-Treibermodell.
Die Native 802.11 IHV-Erweiterbarkeitsfunktionen werden vom Betriebssystem bereitgestellt und von der IHV-Erweiterungen-DLL aufgerufen, um Folgendes zu tun:
- Ordnen Sie Puffer zu, die im Native 802.11-Framework verwendet werden, und geben Sie sie frei.
- Senden Sie Pakete, z. B. ein paket, das von einem Authentifizierungsalgorithmus definiert ist, über den WLAN-Adapter (Wireless LAN) des IHV.
- Konfigurieren Sie den WLAN-Adapter des IHV mit verschiedenen Sicherheitseinstellungen für alle Authentifizierungs- und Verschlüsselungsalgorithmen, die von der IHV-Erweiterungen-DLL unterstützt werden.
- Schnittstelle mit der DLL für IHV-UI-Erweiterungen (falls installiert), um Ereignisbenachrichtigungen zu verarbeiten. Beispielsweise könnte die IHV-Erweiterungen-DLL die IHV-UI-Erweiterungen-DLL über die verschiedenen Phasen benachrichtigen, die an einer BSS-Netzwerkverbindung (Basic Service Set) beteiligt sind.
Weitere Informationen zur DLL für IHV-UI-Erweiterungen finden Sie unter Native 802.11 IHV UI Extensions DLL.
Hinweis
Die IHV-Erweiterungen-DLL ruft jede Native 802.11-IHV-Erweiterbarkeitsfunktion über einen Funktionszeiger auf, der einem Member der DOT11EXT_APIS-Struktur zugeordnet ist. Wenn das Betriebssystem die IHV-Handlerfunktion Dot11ExtIhvInitService aufruft , übergibt es die Liste der Zeiger über den pDot11ExtAPI-Parameter an die IHV-Erweiterbarkeitsfunktionen.
In der folgenden Tabelle sind die nativen 802.11-IHV-Erweiterbarkeitsfunktionen aufgeführt, die von der DLL für IHV-Erweiterungen aufgerufen werden können. Jede IHV-Erweiterbarkeitsfunktion kann nur unter diesen Bedingungen aufgerufen werden.
- Aufgerufen nach der Dienstinitialisierung
Die IHV-Erweiterbarkeitsfunktion kann erst aufgerufen werden, nachdem die IHV-Handlerfunktion Dot11ExtIhvInitService aufgerufen wurde, um die DLL für IHV-Erweiterungen zu initialisieren. Außerdem kann die Erweiterungen-DLL die IHV-Erweiterbarkeitsfunktion nicht aufrufen, nachdem die IHV-Handlerfunktion Dot11ExtIhvDeinitService aufgerufen wurde. - Aufgerufen nach der Adapterinitialisierung
Die IHV-Erweiterbarkeitsfunktion kann erst aufgerufen werden, nachdem die IHV-Handlerfunktion Dot11ExtIhvInitAdapter aufgerufen wurde, um die Schnittstelle für den WLAN-Adapter des IHV zu initialisieren.
Die IHV-Erweiterbarkeitsfunktion erfordert ein Handle, das den WLAN-Adapter identifiziert. Wenn Dot11ExtIhvInitAdapter aufgerufen wird, wird die IHV-Erweiterungen-DLL dieses Handle über den hDot11SvcHandle-Parameter übergeben.
Die Erweiterungen-DLL kann die IHV-Erweiterbarkeitsfunktion nicht aufrufen, nachdem die IHV-Handlerfunktion Dot11ExtIhvDeinitAdapter aufgerufen wurde. - Aufgerufen nach Vorzuordnung
Die IHV-Erweiterbarkeitsfunktion kann nur aufgerufen werden, nachdem die Dot11ExtIhvPerformPerformPreAssociate IHV-Handlerfunktion aufgerufen wurde, um einen Vorzuordnungsvorgang mit einem BSS-Netzwerk (Basic Service Set) zu initiieren.
Die IHV-Erweiterbarkeitsfunktion erfordert ein Handle, das die BSS-Netzwerkverbindung identifiziert. Wenn Dot11ExtIhvPerformPreAssociate aufgerufen wird, wird die IHV-Erweiterungen-DLL dieses Handle über den hConnection-Parameter übergeben.
Die Erweiterungen-DLL kann die IHV-Erweiterbarkeitsfunktion nicht aufrufen, nachdem die IHV-Handlerfunktionen Dot11ExtIhvDeinitAdapter oder Dot11ExtIhvAdapterReset aufgerufen wurden. - Aufgerufen nach Post-Association
Die IHV-Erweiterbarkeitsfunktion kann nur aufgerufen werden, nachdem die IHV-Handlerfunktion Dot11ExtIhvPerformPostAssociate aufgerufen wurde, um einen Vorgang nach der Zuordnung mit einem BSS-Netzwerk (Basic Service Set) zu initiieren.
Die IHV-Erweiterbarkeitsfunktion erfordert ein Handle, das die Sicherheitssitzung mit der BSS-Netzwerkverbindung identifiziert. Wenn Dot11ExtIhvPerformPostAssociate aufgerufen wird, wird die IHV-Erweiterungen-DLL dieses Handle über den hSecuritySessionID-Parameter übergeben.
Die Erweiterungen-DLL kann die IHV-Erweiterbarkeitsfunktion nicht aufrufen, nachdem die IHV-Handlerfunktionen Dot11ExtIhvDeinitAdapter oder Dot11ExtIhvAdapterReset aufgerufen wurden.
Funktion | Aufgerufen nach der Dienstinitialisierung | Aufgerufen nach der Adapterinitialisierung | Aufgerufen nach vor der Zuordnung | Nach der Zuordnung aufgerufen |
---|---|---|---|---|
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 |
Weitere Informationen zu IHV-Handlerfunktionen finden Sie unter Native 802.11 IHV-Handlerfunktionen.