fonction de rappel DOT11EXT_ALLOCATE_BUFFER (wlanihv.h)

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.

 

La DLL extensions IHV appelle la fonction Dot11ExtAllocateBuffer pour allouer de la mémoire pour les mémoires tampons de longueur variable.

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 de retour

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.

Retourner le code	Description
ERROR_SUCCESS	L’appel a réussi sans erreur.
ERROR_OUTOFMEMORY	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 d’extensions IHV doit appeler cette fonction lors du renvoi 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 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.

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

Dot11ExtIhvCreateDiscoveryProfiles

Dot11ExtFreeBuffer