LMemoryFile::SaveFileBufferCallBack

#include "ltwrappr.h"

virtual L_INT LMemoryFile::SaveFileBufferCallBack(pLBuffer, uRequiredSize)

LBuffer * pLBuffer;	/* pointer to an LBuffer object */
L_SIZE_T uRequiredSize;	/* buffer size */

This function is called if the buffer of the LBuffer object used by the LMemoryFile::SaveFileBuffer function is not large enough to accommodate the file in memory. This function gives the user the opportunity to reallocate the buffer to an adequate size.

Parameter	Description
pLBuffer	Pointer to an LBuffer object into which the bitmap will be saved. This pointer can be used to increase the size of the buffer of the LBuffer object.
uRequiredSize	Minimum buffer size, in bytes, required to save the bitmap or file.

Returns

SUCCESS	The function was successful.
FAILURE	An error occurred.

Comments

This callback function is optional, but recommended. If the callback is not used, then the user must provide the LMemoryFile::SaveFileBuffer function with a buffer that is large enough to hold the memory file. If the buffer is not large enough and the callback is not used, LMemoryFile::SaveFileBuffer will fail.

To use this function, the user must derive a new class from the LMemoryFile class and override this function. The use of this callback function must also be enabled by calling LBase::EnableCallBack.

If the callback successfully reallocates the buffer, it should return SUCCESS.

If the callback fails to successfully reallocate the buffer, it should return FAILURE.

This function does not support signed data images, unless they are DICOM images. It returns the error code ERROR_SIGNED_DATA_NOT_SUPPORTED if a signed data image that is not a DICOM image is passed to this function.

Required DLLs and Libraries

LTFIL
File format DLLs

For a listing of the exact DLLs and Libraries needed, based on the toolkit version, refer to Files To Be Included With Your Application.

Platforms

Win32, x64.

See Also

Functions:	LMemoryFile::SaveFileBuffer, LMemoryFile::SaveBitmapBuffer, LMemoryFile::SaveBitmapBufferCallBack, LMemoryFile::SaveFileCallBack, LBase::EnableCallBack, Class Members
Topics:	Raster Image Functions: Saving Files
	Raster Image Functions: Redirecting Input and Output
	Raster Image Functions: Input and Output
	Loading and Saving Images

Example

// Derive a new class from LMemoryFile and
// override LMemoryFile::SaveFileBufferCallBack
class LUserMemoryFileSMB : public LMemoryFile
{
   virtual L_INT SaveFileBufferCallBack(LBuffer * pLBuffer,
                                        L_UINT32 uRequiredSize)
   {
      L_TCHAR szMessage[128];
      wsprintf(szMessage, TEXT("Initial LEAD buffer size: %d\n"), pLBuffer->GetSize());
      wsprintf(szMessage, TEXT("%sThe required size: %d"), szMessage, uRequiredSize);
      MessageBox(NULL, szMessage, TEXT("Buffer Info"), MB_OK);
      // Try to reallocate the LEAD buffer 
      L_INT nRet = pLBuffer->Reallocate(uRequiredSize);
      
      if (nRet == SUCCESS)
         return SUCCESS;
      else
         return FAILURE;
   }
};
L_INT LMemoryFile__SaveFileBufferCallBackExample(LBitmapBase & Bitmap)
{
   LUserMemoryFileSMB MemoryFile;
   LBuffer Buffer(1000);   // 1000 bytes initially
   L_SIZE_T dwFileSize;
   MemoryFile.SetBitmap(&Bitmap);
   if (!MemoryFile.IsCallBackEnabled())
      MemoryFile.EnableCallBack(TRUE);
   return MemoryFile.SaveFileBuffer(&Buffer,
                                    &dwFileSize,
                                    FILE_TIF,
                                    0,
                                    QS,
                                    SAVEFILE_FIXEDPALETTE,
                                    NULL);
}