##### Synopsis

    #include <ctl_api.h>
    unsigned *ctl_memory_area_allocate(CTL_MEMORY_AREA_t *memory_area);

##### Description

The function ctl_memory_area_allocate is given a pointer to the memory_area which has been initialised. This function returns a block of the size specified in the call to ctl_memory_area_init or zero if no blocks are available.

##### Portability

ctl_memory_area_allocate is provided in every implementation of the CrossWorks tasking library.

##### See Also

Memory areas, ctl_memory_area_init