ImageGear for C and C++ on Windows v21.0 - Updated
API Reference Guide / Core Component API Reference / Core Component Callback Functions Reference / LPFNIG_MEM_ALLOC
In This Topic
    LPFNIG_MEM_ALLOC
    In This Topic

    Create a function of this type to give your application the flexibility of replacing ImageGear's memory allocation routine with your own.

    Declaration:

     
    Copy Code
    typedef LPBYTE (ACCUAPI LPFNIG_MEM_ALLOC)(AT_UINT nSize);
    

    Arguments:

    Name Type Description
    nSize AT_UINT Number of bytes to allocate.

    Return Value:

    The user supplied callback function should return a pointer to the allocated block of memory.

    Supported Raster Image Formats:

    This function does not process image pixels.

    Sample:

    Filters

    Example:

     
    Copy Code
    /**************************************************************/
    /* Memory Alloc callback function definition */
    /*************************************************************/
    LPBYTE  ACCUAPI MyMemAlloc(AT_UINT nSize) /* number of bytes to alloc*/
    {
            /* Put your own memory allocation code here */
            return( buffer);
    };
    /*See also example for IG_mem_CB_register() */
    

    Remarks:

    This callback function is registered by calling IG_mem_CB_register(). The register function must be called prior to any user-defined callback functions being used by the ImageGear library.

    Your memory allocation function will only be used when large allocations (allocations greater than 1024) are performed.