DOT11EXTIHV_RECEIVE_PACKET fonction de rappel (wlanihv.h)

Important L’interface LAN sans fil Native 802.11 est déconseillée dans Windows 10 et versions ultérieures. Utilisez l’interface WDI (Wlan Device Driver Interface) à la place. Pour plus d’informations sur WDI, consultez Modèle de pilote Windows universel WLAN.
 
Le système d’exploitation appelle la fonction Dot11ExtIhvReceivePacket pour transférer un paquet, reçu par l’adaptateur LAN sans fil (WLAN), vers la DLL des extensions IHV à des fins de 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 des extensions IHV pour référencer l’adaptateur WLAN. Cette valeur de handle a été spécifiée par le biais d’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 du paquet, comme décrit dans la section Remarques.

Valeur retournée

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 événements suivants 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 des extensions IHV par le biais d’un appel à 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 gestion des en-têtes MAC 802.11
  • IEEE EtherType (2 octets)
  • Payload

Configuration requise

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

Voir aussi

Dot11ExtSetEtherTypeHandling

Dot11ExtIhvInitAdapter