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

Developer

API Reference

IREALLOC_ERRMALLOCNAMENOZI()

Brew Release
Brew MP 1.0.2
See Also
IRealloc_ErrReallocNameNoZI() IRealloc_ErrMallocName()
Description
Helper function for doing allocations.
Params
piRealloc
[]:
pointer to the IRealloc interface
nSize
[]:
the requested size of the block
ppOut
[]:
(out) on exit, *ppOut will have the new pointer to the block, or NULL if no block was allocated.
cpszName
[]:
pointer to a zero-terminated character string containing the debug name for this block, or NULL for no name.
Prototype
  •    int IRealloc_ErrMallocNameNoZI(IRealloc *piRealloc,
                                      int nSize,
                                      void **ppOut,
                                      const char *cpszName);
    
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 Another error from AEEStdErr.h, if appropriate
Side Effect
  • None
Comments
This helper sets *ppOut to NULL to indicate that a new allocation is requested, and then chains to IRealloc_ErrReallocNameNoZI(). Any newly allocated space is not guaranteed to be zero-filled. When zero-filled allocation is not required, this method may be more efficient than IRealloc_ErrMallocName(). Negative values for nSize should be avoided.