# MI_CallAlloc

## Syntax

  `#include <nitro/mi.h>
  void* MI_CallAlloc(MIAllocator *allocator, u32 length, u32 alignment);`

## Arguments

allocator | Pointer to the `MIAllocator` structure to access. The allocator must have been initialized using `MI_InitAllocator()`.
length | Memory size to be allocated.
alignment | Boundary alignment required for memory addresses.

## Return Values

Returns the memory actually allocated if successful; otherwise returns NULL.

## Description

Allocates memory from the allocator using the `MIAllocator` structure.

Internally, this just calls the callback function for memory allocation specified in `MI_InitAllocator()`.
For more information, see the reference for the `MIAllocator` structure.

## See Also

`MIAllocator, MIAllocatorAllocFunction, MIAllocatorFreeFunction
MI_InitAllocator, MI_CallFree`

## Revision History

2007/06/12 Initial version.

CONFIDENTIAL