DOT11EXT_SEND_PACKET fonction de rappel (wlanihv.h)

Article
03/01/2024

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.

La DLL d’extensions IHV appelle la fonction Dot11ExtSendPacket pour transmettre un paquet via l’adaptateur LAN sans fil (WLAN).

Syntaxe

DOT11EXT_SEND_PACKET Dot11extSendPacket;

DWORD Dot11extSendPacket(
  [in, optional] HANDLE hDot11SvcHandle,
  [in]           ULONG uPacketLen,
  [in]           LPVOID pvPacket,
  [in, optional] HANDLE hSendCompletion
)
{...}

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 par le biais d’un appel précédent à la fonction de gestionnaire IHV Dot11ExtIhvInitAdapter .

[in] uPacketLen

Longueur, en octets, de la mémoire tampon allouée à l’appelant référencée par le paramètre pvPacket .

[in] pvPacket

Pointeur vers une mémoire tampon allouée à l’appelant qui contient les données à transmettre, comme décrit dans la section Remarques.

[in, optional] hSendCompletion

Valeur de handle qui identifie de manière unique le paquet d’envoi.

Lorsque l’adaptateur WLAN termine l’opération d’envoi, le système d’exploitation avertit la DLL des extensions IHV par le biais d’un appel à Dot11ExtIhvSendPacketCompletion Fonction de gestionnaire IHV. Lors de cet appel, le système d’exploitation transmet la valeur de handle du paquet via le paramètre hSendCompletion .

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

La DLL des extensions IHV doit suivre ces instructions lors de l’appel de la fonction Dot11ExtSendPacket .

Le paquet envoyé via un appel de la fonction Dot11ExtSendPacket se termine de manière asynchrone. La DLL des extensions IHV ne doit pas libérer la mémoire référencée par le paramètre pvPacket tant que le Dot11ExtIhvSendPacketCompletion La fonction gestionnaire IHV est appelée avec la même valeur de handle que le paramètre hSendCompletion .
La DLL des extensions IHV doit définir le paramètre hSendCompletion sur une valeur qui identifie de manière unique les données de paquet référencées par le paramètre pvPacket .

Pour plus d’informations sur les fonctions de gestionnaire IHV, consultez Fonctions de gestionnaire IHV natives 802.11.

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

Ces données de paquets sont passées au pilote miniport.

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

Fonctions de gestionnaire IHV 802.11 natives

Dot11ExtIhvSendPacketCompletion

Dot11ExtIhvInitAdapter

802.11 Gestion des en-têtes MAC

Partager via