====== zbuffer_Init ======

===== Description =====

Allocate memory in a buffer variable.

===== Files =====

^ Declaration | ''Zeolite.h'' |
^ Implementation | ''Zeolite.cpp'' |

===== Function prototype =====

<code="C">bool zbuffer_Init(ZVAR hBuf, long nItems, long ItemSize);</code>

===== Arguments =====

^ Name ^ Type ^ Comment ^
| hBuf | ZVAR | A handle to the buffer variable to be initialised. |
| nItems | long | The number of items for which memory is to be allocated. |
| ItemSize | long | The size, in bytes, of the items in the buffer. |

===== Return value =====

False if an error occurred, and true otherwise.

===== Comments =====

==== Memory is zeroed on initialisation =====

The memory in a buffer variable is initialised as zeroes by ''zbuffer_Init''.