Allocates a block of memory from the internal library heap
#include <WinAPIMem.au3>
_WinAPI_CreateBuffer ( $iLength [, $pBuffer = 0 [, $bAbort = True]] )
| $iLength | The required buffer length, in bytes. |
| $pBuffer | [optional] A pointer to the existing buffer that to be replaced by a new buffer. If this parameter is a valid buffer pointer, the memory will be reallocated for a new buffer. However, the new memory is allocated at a different location. Therefore, you should always use the pointer that returns this function. If this parameter is 0 (Default) or invalid buffer pointer, the function just allocates a new memory. |
| $bAbort | [optional] Specifies whether to exit the script if not enough memory, valid values: True - Displaying an error message and exit the script with error code 1 (Default). False - Continue the script and return an error. |
| Success: | A pointer to the new buffer. |
| Failure: | 0 and sets the @error flag to non-zero (if an exceptions is not set). |
When a buffer is no longer needed, you must destroy it by calling the _WinAPI_FreeMemory() function.