API Reference | developer.brewmp.com API Reference | developer.brewmp.com

Developer

API Reference

IREALLOC_ERRREALLOC()

Brew Release
Brew MP 1.0.2
See Also
IRealloc_ErrReallocNoZI() _HEAP_DEBUG IRealloc_ErrReallocName()
Description
Makes an allocation request to the heap object with zero-initialization.
Params
piRealloc
[]:
pointer to the IRealloc interface
nSize
[]:
the requested new size of the block, or zero (0) to request that the block be freed.
ppOut
[]:
(in/out) on entry, *ppOut should have the existing pointer to the block; on exit, *ppOut will have the new pointer to the block, or NULL if a block was freed. On failure, *ppOut is unchanged.
Interface
Prototype
  •    int IRealloc_ErrRealloc(IRealloc *piRealloc,
                               int nSize,
                               void **ppOut);
    
Return
  • AEE_SUCCESS - Allocation (or free) was successful AEE_ENOMEMORY - Not enough memory to fulfill the request AEE_EHEAP - An internal heap error was detected AEE_EMEMPTR - An invalid pointer was detected Another error from AEEStdErr.h, if appropriate
Side Effect
  • None
Comments
Any newly allocated space is guaranteed to be zero-filled. When zero-filled allocation is not required, the non-zero-filling alternative IRealloc_ErrReallocNoZI() may be more efficient. If _HEAP_DEBUG is defined to a non-zero value, IRealloc_ErrRealloc() is silently converted to IRealloc_ErrReallocName() with a debug name containing the source file name and line number where the method is used. Negative values for nSize should be avoided.