DOT11EXT_SET_ETHERTYPE_HANDLING fonction de rappel (wlanihv.h)

Article
03/05/2024

Important L’interface LAN sans fil Native 802.11 est déconseillée dans Windows 10 et versions ultérieures. Utilisez plutôt l’interface WDI (WLAN Device Driver Interface). Pour plus d’informations sur WDI, consultez Modèle de pilote Windows universel WLAN.

La DLL des extensions IHV appelle la fonction Dot11ExtSetEtherTypeHandling pour effectuer les opérations suivantes :

Configurez l’adaptateur LAN sans fil (WLAN) avec une liste d’exemptions de déchiffrement de paquets. Chaque exemption est appliquée en fonction de l’etherType IEEE du paquet reçu.
Inscrivez-vous auprès du système d’exploitation pour les EtherTypes des paquets reçus qui seront transférés vers la DLL des extensions IHV via des appels à la fonction gestionnaire IHV Dot11ExtIhvReceivePacket .

Syntaxe

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

Paramètres

[in, optional] hDot11SvcHandle

Handle utilisé par le système d’exploitation pour référencer l’adaptateur WLAN. Cette valeur de handle a été spécifiée lors d’un appel précédent à la fonction gestionnaire IHV Dot11ExtIhvInitAdapter .

[in] uMaxBackLog

Nombre maximal de paquets reçus que le système d’exploitation met en file d’attente si la DLL des extensions IHV n’a pas été retournée à partir d’un appel à la fonction gestionnaire IHV Dot11ExtIhvReceivePacket . Lorsque uMaxBackLog est atteint, le système d’exploitation ignore le paquet le plus ancien de la file d’attente.

[in] uNumOfExemption

Nombre d’entrées dans le tableau d’exemptions de confidentialité référencées par le paramètre pExemption . La valeur zéro désactive les exemptions de confidentialité sur l’adaptateur WLAN.

[in, optional] pExemption

Pointeur vers un tableau d’exemptions de confidentialité. Chaque entrée du tableau est mise en forme en tant que DOT11_PRIVACY_EXEMPTION structure.

[in] uNumOfRegistration

Nombre d’entrées dans le tableau d’inscriptions IEEE EtherType référencées par le paramètre pusRegistration . La valeur zéro désactive la capacité de la DLL des extensions IHV à recevoir tous les paquets via des appels à la fonction gestionnaire IHV Dot11ExtIhvReceivePacket .

[in, optional] pusRegistration

Pointeur vers un tableau d’inscriptions IEEE EtherType. Chaque entrée a la valeur EtherType au format big-endian.

Valeur retournée

Si l’appel réussit, la fonction retourne ERROR_SUCCESS. Sinon, il retourne un code d’erreur défini dans Winerror.h.

Remarques

Lors de l’appel de la fonction Dot11ExtSetEtherTypeHandling , la DLL des extensions IHV doit suivre les instructions suivantes :

La DLL des extensions IHV peut appeler Dot11ExtSetEtherTypeHandling à partir des appels à Dot11ExtIhvInitAdapter ou Dot11ExtIhvPerformPreAssociate Fonctions de gestionnaire IHV.
La DLL des extensions IHV ne doit pas appeler Dot11ExtSetEtherTypeHandling après avoir effectué l’opération de pré-association via un appel à Dot11ExtPreAssociateCompletion.

Le système d’exploitation utilise par défaut une liste vide d’exemptions de confidentialité et d’inscriptions EtherType avant l’appel de la fonction Gestionnaire IHV Dot11ExtIhvInitAdapter .

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Disponible dans Windows Vista et les versions ultérieures des systèmes d’exploitation Windows.
Plateforme cible	Desktop (Expérience utilisateur)
En-tête	wlanihv.h (inclure Wlanihv.h)