_init_boxf

#include <membox.h>

int _init_boxf (
  void far *box_mem,          /* pool address */
  unsigned int box_mem_size,  /* pool size */
  unsigned int box_size);     /* block size */

The _init_boxf routine initializes a fixed block size memory pool. The box_mem argument specifies the starting address of the pool and the box_mem_size argument specifies the size of the pool (in bytes). The box_size argument specifies the size of each block (in bytes).

Note

• This routine is reentrant and thread-safe. It may be called from the main function and an interrupt with no restrictions.
• The _init_boxf function requires only 6 bytes for internal handling of the data pool. All the remaining memory is available to the user. The _init_boxf function is therefore a lot more efficient than the ANSI C standard memory allocation functions.

The _init_boxf routine returns a value of 1 if the memory box was initialized with no problems or a value of 0 to indicate an initialization error.

_alloc_boxf, _calloc_boxf, _free_boxf