Data Fields

HeapBufMP_Params Struct Reference

Structure defining parameters for the HeapBufMP module. More...

#include <HeapBufMP.h>

Data Fields

String name
UInt16 regionId
SizeT blockSize
UInt numBlocks
SizeT align
Bool exact
GateMP_Handle gate

Detailed Description

Structure defining parameters for the HeapBufMP module.

Field Documentation

Name of this instance.

The name (if not NULL) must be unique among all HeapBufMP instances in the entire system. When creating a new heap, it is necessary to supply an instance name.

The name does not have to be persistent. The supplied string is copied into persistent memory.

Shared region ID

The index corresponding to the shared region from which shared memory will be allocated.

Size (in MAUs) of each block.

HeapBufMP will round the blockSize up to the nearest multiple of the alignment, so the actual blockSize may be larger. When creating a HeapBufMP dynamically, this needs to be taken into account to determine the proper buffer size to pass in.

Required parameter.

The default size of the blocks is 0 MAUs.

Number of fixed-size blocks.

This is a required parameter for all new HeapBufMP instances.

Alignment (in MAUs) of each block.

The alignment must be a power of 2. If the value 0 is specified, the value will be changed to meet minimum structure alignment requirements and the cache alignment size of the region in which the heap will be placed. Therefore, the actual alignment may be larger.

The default alignment is 0.

Use exact matching

Setting this flag will allow allocation only if the requested size is equal to (rather than less than or equal to) the buffer's block size.

GateMP used for critical region management of the shared memory

Using the default value of NULL will result in use of the GateMP system gate for context protection.

The documentation for this struct was generated from the following file:
 All Data Structures Files Functions Variables Typedefs Enumerations Enumerator Defines

Copyright 2011, Texas Instruments Incorporated