Alloue un bloc de mémoire sur le tas
#include <WinAPIMem.au3>
_WinAPI_CreateBuffer ( $iLength [, $pBuffer = 0 [, $bAbort = True]] )
| $iLength | La longueur de la mémoire tampon souhaitée, en octets. |
| $pBuffer | [optionnel] Un pointeur sur un tampon existant qui doit être remplacé par le nouveau tampon. Si ce paramètre est un pointeur vaide de tampon, la mémoire sera réaffecté au nouveau tampon. Cependant, la nouvelle mémoire est allouée à un endroit différent. Par conséquent, vous devriez toujours utiliser le pointeur que cette fonction retourne. Si ce paramètre est 0 (par défaut) ou un pointeur de tampon invalide, la fonction alloue simplement une nouvelle mémoire. |
| $bAbort | [optionnel] Spécifie s'il faut quitter le script s'il n'y a pas assez de mémoire, les valeurs valides sont: True - Affiche un message d'erreur et termine le script avec le code d'erreur 1 (par défaut). False - Continue le script et retourne une erreur. |
| Succès: | Retourne un pointeur sur le nouveau tampon. |
| Échec: | Retourne 0 et définit @error <> 0 (si une exception n'est pas défini). |
Quand le tampon n'est plus nécessaire, vous devez le détruire en appelant la fonction _WinAPI_FreeMemory().