fonction de rappel DOT11EXTIHV_RECEIVE_PACKET (wlanihv.h)

Article
02/07/2025

important l’interface Native 802.11 Wireless LAN est déconseillée dans Windows 10 et versions ultérieures. Utilisez à la place l’interface WDI (Device Driver Interface) DU RÉSEAU LOCAL. Pour plus d’informations sur WDI, consultez modèle de pilote Windows universel LOCAL.

Le système d’exploitation appelle la fonction Dot11ExtIhvReceivePacket pour transférer un paquet, reçu par l’adaptateur LAN (WLAN) sans fil, à la DLL des extensions IHV pour traitement.

Syntaxe

DOT11EXTIHV_RECEIVE_PACKET Dot11extihvReceivePacket;

DWORD Dot11extihvReceivePacket(
  [in, optional] HANDLE hIhvExtAdapter,
  [in]           DWORD dwInBufferSize,
  [in]           LPVOID pvInBuffer
)
{...}

Paramètres

[in, optional] hIhvExtAdapter

Handle utilisé par la DLL d’extensions IHV pour référencer l’adaptateur WLAN. Cette valeur de handle a été spécifiée via un appel précédent à la fonction de gestionnaire IHV Dot11ExtIhvInitAdapter.

[in] dwInBufferSize

Longueur, en octets, du paquet reçu référencé par le paramètre pvInBuffer.

[in] pvInBuffer

Pointeur vers une mémoire tampon, allouée par le système d’exploitation, qui contient les données de paquet, comme décrit dans la section Remarques.

Valeur de retour

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

Remarques

Le système d’exploitation appelle la fonction Dot11ExtIhvReceivePacket lorsque les opérations suivantes se produisent :

L’adaptateur WLAN reçoit un paquet et le pilote miniport Native 802.11, qui gère l’adaptateur, indique le paquet au système d’exploitation.
L’EtherType IEEE du paquet correspond à une entrée dans la liste des EtherTypes spécifiés par la DLL d’extensions IHV via un appel à la Fonction dot11ExtSetEtherTypeHandling.

La mémoire tampon pointée par pvPacket doit contenir les données de paquet suivantes, spécifiées dans l’ordre d’octet du réseau :

Adresse MAC de destination (6 octets), mise en forme conformément aux instructions décrites dans 802.11 Gestion des en-têtes MAC
IEEE EtherType (2 octets)
Charge utile

Exigences

Exigence	Valeur
client minimum pris en charge	Disponible dans Windows Vista et versions ultérieures des systèmes d’exploitation Windows.
plateforme cible	Bureau
d’en-tête	wlanihv.h (include Wlanihv.h)

Voir aussi

Dot11ExtSetEtherTypeHandling

Dot11ExtIhvInitAdapter

Partager via