LAnnContainer::LoadMemory

#include "ltwrappr.h"

virtual L_INT LAnnContainer::LoadMemory(pMem, uMemSize)

L_UCHAR L_FAR * pMem;	/* pointer to the file in memory to be loaded */
L_UINT32 uMemSize;	/* size of the file in memory */

Loads an annotation from a file that is stored in memory. This function is available in the Document/Medical Toolkits.

Parameter	Description
pMem	Pointer to the file in memory to be loaded.
uMemSize	Size of the file in memory (in bytes).

Returns

SUCCESS	The function was successful.
< 1	An error occurred. Refer to Return Codes.

Comments

If this function returns SUCCESS and phObject is updated with NULL, there are no annotation objects to load.

Required DLLs and Libraries

LTANN

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

See Also

Functions:	LAnnContainer::DeletePage, LAnnContainer::DeletePageMemory, LAnnContainer::DeletePageOffset, LAnnContainer::FileInfo, LAnnContainer::FileInfoMemory, LAnnContainer::FileInfoOffset, Class Members, LAnnotation::GetOptions, LAnnotation::SetOptions
Topics:	Annotation Functions: Input and Output
	Implementing Annotations
	New Annotation Features of Version 14.5

Example

L_VOID TestLoadSaveAnnMem(LAnnContainer L_FAR * pLeadAContainer)
{
   LAnnContainer TmpContainer ;// Temporary container for the annotations
   HGLOBAL hFileInMemory;// Memory handle
   L_UINT32 uMemSize; // Size of the data in memory
   L_UCHAR L_FAR *pData; // Pointer to the data in memory

   // Load the initial annotations
   TmpContainer.Load( TEXT("TEST.ANN"));

   hFileInMemory = GlobalAlloc(GMEM_MOVEABLE,1024) ;

   // Save the annotations as a file in memory
   TmpContainer.SaveMemory( ANNFMT_NATIVE, FALSE, &hFileInMemory, &uMemSize);

   // Destroy the temporary container
   TmpContainer.Destroy( ANNFLAG_RECURSE);

   // Get the pointer to the memory-resident file
   pData = (L_UCHAR L_FAR *) GlobalLock (hFileInMemory);

   // Load the new file from memory
   pLeadAContainer->LoadMemory((L_UCHAR L_FAR *)pData, uMemSize);

   /* Clean up */
   GlobalUnlock (hFileInMemory);
   GlobalFree (hFileInMemory);
}