This method must return the layout of the memory in a specific block. No two blocks with the same parent can overlap. This call returns existing memory blocks only. The caller can assume that any memory that is not in a block is a gap or invalid memory.

virtual CADIReturn_t CADI::CADIMemGetBlocks(uint32_t memorySpace, 
                                            uint32_t memBlockIndex,
                                            uint32_t desiredNumOfMemBlocks, 
                                            uint32_t *actualNumOfMemBlocks,
                                            CADIMemBlockInfo_t *memBlocks) = 0;

memorySpace

is the ID of the memory space for which the caller requests a block list.

memBlockIndex

is the index into the internal buffer of memory blocks held by the target for the specified memory space.

desiredNumOfMemBlocks

is the required number of memory blocks.

actualNumOfMemBlocks

is the is the total number of blocks returned by the target. It is less than the number requested if the number requested is more than the number available.

memBlocks

is a buffer that must be big enough to hold the required number of CADIMemBlockInfo_t structs. Space is allocated, and deallocated if applicable, by the caller.