DOT11EXT_SET_ETHERTYPE_HANDLING Rückruffunktion (wlanihv.h)

Artikel
08/08/2023

Wichtig Die native WLAN-Schnittstelle 802.11 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 driver model.

Die DLL für IHV-Erweiterungen ruft die Dot11ExtSetEtherTypeHandling-Funktion auf, um folgendes auszuführen:

Konfigurieren Sie den WLAN-Adapter (Wireless LAN) mit einer Liste von Paketentschlüsselungsausnahmen. Jede Ausnahme wird basierend auf dem IEEE-EtherType des empfangenen Pakets angewendet.
Registrieren Sie sich beim Betriebssystem für die EtherTypes empfangener Pakete, die über Aufrufe der Dot11ExtIhvReceivePacket IHV-Handlerfunktion an die DLL für IHV-Erweiterungen weitergeleitet werden.

Syntax

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
)
{...}

Parameter

[in, optional] hDot11SvcHandle

Das Handle, das vom Betriebssystem verwendet wird, um auf den WLAN-Adapter zu verweisen. Dieser Handlewert wurde durch einen vorherigen Aufruf der IHV-Handlerfunktion Dot11ExtIhvInitAdapter angegeben.

[in] uMaxBackLog

Die maximale Anzahl empfangener Pakete, die das Betriebssystem in die Warteschlange stellt, wenn die DLL für IHV-Erweiterungen nicht von einem Aufruf der IHV-Handlerfunktion Dot11ExtIhvReceivePacket zurückgegeben wurde. Wenn uMaxBackLog erreicht ist, verwirft das Betriebssystem das älteste Paket in der Warteschlange.

[in] uNumOfExemption

Die Anzahl der Einträge innerhalb des Arrays für Datenschutzausnahmen, auf das vom pExemption-Parameter verwiesen wird. Der Wert 0 deaktiviert Datenschutzausnahmen auf dem WLAN-Adapter.

[in, optional] pExemption

Ein Zeiger auf ein Array von Datenschutzausnahmen. Jeder Eintrag im Array ist als formatiert. DOT11_PRIVACY_EXEMPTION Struktur.

[in] uNumOfRegistration

Anzahl der Einträge innerhalb des IEEE EtherType-Registrierungsarrays, auf das vom Parameter pusRegistration verwiesen wird. Der Wert 0 deaktiviert die Fähigkeit der IHV-Erweiterungs-DLL, pakete über Aufrufe der IHV-Handlerfunktion Dot11ExtIhvReceivePacket zu empfangen.

[in, optional] pusRegistration

Ein Zeiger auf ein Array von IEEE EtherType-Registrierungen. Jeder Eintrag hat den EtherType-Wert im Big-Endian-Format.

Rückgabewert

Wenn der Aufruf erfolgreich ist, gibt die Funktion ERROR_SUCCESS zurück. Andernfalls wird ein in Winerror.h definierter Fehlercode zurückgegeben.

Hinweise

Beim Aufrufen der Dot11ExtSetEtherTypeHandling-Funktion muss die DLL für IHV-Erweiterungen die folgenden Richtlinien befolgen:

Die DLL für IHV-Erweiterungen kann Dot11ExtSetEtherTypeHandling innerhalb der Aufrufe von Dot11ExtIhvInitAdapter oder aufrufen. Dot11ExtIhvPerformPreAssociate IHV-Handlerfunktionen.
Die DLL für IHV-Erweiterungen darf Dot11ExtSetEtherTypeHandling nicht aufrufen, nachdem der Vorgang vor der Zuordnung durch einen Aufruf von erfolgreich abgeschlossen wurde. Dot11ExtPreAssociateCompletion.

Das Betriebssystem verwendet standardmäßig eine leere Liste von Datenschutzausnahmen und EtherType-Registrierungen vor dem Aufruf der IHV-Handlerfunktion Dot11ExtIhvInitAdapter .

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Verfügbar in Windows Vista und höheren Versionen der Windows-Betriebssysteme.
Zielplattform	Desktop
Kopfzeile	wlanihv.h (wlanihv.h einschließen)