DOT11EXT_ALLOCATE_BUFFER fonction de rappel (wlanihv.h)
Syntaxe
DOT11EXT_ALLOCATE_BUFFER Dot11extAllocateBuffer;
DWORD Dot11extAllocateBuffer(
[in] DWORD dwByteCount,
[out] LPVOID *ppvBuffer
)
{...}
Paramètres
[in] dwByteCount
Taille, en octets, de la mémoire tampon à allouer.
[out] ppvBuffer
Pointeur vers une variable fournie par l’appelant qui stocke l’adresse de la mémoire tampon allouée. Le paramètre ppvBuffer a une valeur non null valide si la valeur de retour est ERROR_SUCCESS.
Valeur retournée
L’appel retourne un code ERROR_xxxx défini dans Winerror.h. Les codes ERROR_xxxx suivants sont généralement retournés par la fonction Dot11ExtAllocateBuffer .
Code de retour | Description |
---|---|
|
L’appel a réussi sans erreur. |
|
Le système d’exploitation n’a pas pu allouer la mémoire en raison d’un manque de ressources. |
Remarques
La DLL des extensions IHV doit suivre ces instructions lors de l’appel de la fonction Dot11ExtAllocateBuffer .
-
La DLL des extensions IHV doit appeler cette fonction lors du retour d’une mémoire tampon de longueur variable à partir d’une fonction de gestionnaire IHV. Dans ce cas, le système d’exploitation est chargé de libérer la mémoire tampon après le retour de la fonction gestionnaire IHV.
Pour plus d’informations sur les fonctions de gestionnaire IHV, consultez Fonctions de gestionnaire IHV natives 802.11.
-
La DLL des extensions IHV peut appeler cette fonction pour allouer de la mémoire référencée par la DLL elle-même.
Dans ce cas, la DLL doit libérer la mémoire tampon en appelant Dot11ExtFreeBuffer.
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
Dot11ExtIhvCreateDiscoveryProfiles