Partager via


DOT11EXT_ALLOCATE_BUFFER 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.
 
La DLL extensions IHV appelle la fonction Dot11ExtAllocateBuffer pour allouer de la mémoire aux 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 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
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 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

Dot11ExtFreeBuffer