_alloc_box

#include <rtl.h>

void *_alloc_box (
    void* box_mem );    /* Start address of the memory pool */

The _alloc_box function allocates a block of memory from the memory pool that begins at the address box_mem.

The _alloc_box function is in the RL-RTX library. The prototype is defined in rtl.h.

Note

• You must initialize the memory pool using the _init_box function before performing any other operation on the memory pool.
• The _alloc_box function is reentrant and thread-safe. You can call it from the main function and from an IRQ interrupt function with no restriction.

#include <rtl.h>

/* Reserve a memory for 32 blocks of 20-bytes. */
U32 mpool[32*5 + 3];

void membox_test (void) {
   U8 *box;
   U8 *cbox;

   _init_box (mpool, sizeof (mpool), 20);
   box  = _alloc_box (mpool);
   /* This block is initialized to 0. */
   cbox = _calloc_box (mpool);
    .
    .
   _free_box (mpool, box);
   _free_box (mpool, cbox);
}