DOT11EXT_SEND_PACKET fonction de rappel (wlanihv.h)
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 via un appel précédent à la fonction de gestionnaire IHV Dot11ExtIhvInitAdapter.
[in] uPacketLen
Longueur, en octets, de la mémoire tampon allouée par l’appelant référencée par le paramètre pvPacket.
[in] pvPacket
Pointeur vers une mémoire tampon allouée par l’appelant qui contient les données à transmettre, comme décrit dans la section Remarques.
[in, optional] hSendCompletion
Valeur de handle qui identifie de façon unique le paquet d’envoi.
Une fois l’opération d’envoi terminée, le système d’exploitation avertit la DLL des extensions IHV par le biais d’un appel à la dll d’extension IHV Dot11ExtIhvSendPacketCompletion fonction gestionnaire IHV. Lors de cet appel, le système d’exploitation transmet la valeur de handle du paquet via le paramètre hSendCompletion.
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
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 façon asynchrone. La DLL des extensions IHV ne doit pas libérer la mémoire référencée par le paramètre pvPacket jusqu’à ce que le paramètre Dot11ExtIhvSendPacketCompletion fonction de gestionnaire IHV est appelée avec la même valeur de handle que le paramètre hSendCompletion.
- La DLL d’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.
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
fonctions de gestionnaire IHV natives 802.11
Dot11ExtIhvSendPacketCompletion