# NNS_FndCreateUnitHeap

## Syntax

      #include <nnsys/fnd.h>

      NNSFndHeapHandle    NNS_FndCreateUnitHeap(
                              void*   startAddress,
                              u32     heapSize,
                              u32     memBlockSize);

## Arguments

startAddress | Starting address of the memory region allocated to the heap.
heapSize | Size (in bytes) of the memory region allocated to the heap.
memBlockSize | Memory block size (in bytes)

## Return Values

In the case that it was possible to create a heap, the handle to the heap will be returned. If the function fails, it returns `NNS_FND_HEAP_INVALID_HANDLE` (a NULL value).

## Description

Creates the unit heap. The region for the heap is a memory region of a size designated by `heapSize` from the address designated with `startAddress`.

The size of each memory block is a fixed size designated with `memBlockSize`. The memory block alignment is 4.

## See Also

`NNS_FndCreateUnitHeapEx
`

## Revision History

2004/04/28 The value for when it could not create a heap was incorrect. Revised.
2004/04/01 Initial version.

CONFIDENTIAL