L_GLOBALMEMORYTHRESHOLDS

Summary

The L_GLOBALMEMORYTHRESHOLDS structure is used to control the conventional memory restrictions used when allocating new bitmaps.

Syntax

typedef struct _L_GLOBALMEMORYTHRESHOLDS 
{ 
   L_UINT uStructSize; 
   L_INT64 MaximumConventionalMemory; 
} L_GLOBALMEMORYTHRESHOLDS, *pL_GLOBALMEMORYTHRESHOLDS;

Members

uStructSize

Size of this structure in bytes, for versioning. Use the sizeof() operator to calculate this value.

MaximumConventionalMemory

Maximum size of continuous conventional memory in bytes to use when creating a bitmap.

Comments

The value of MaximumConventionalMemory can be set to any of the following:

Value	Meaning
0	No Maximum. The toolkit will try to use as much conventional memory as possible to create the image. This is the default behavior.
>0	Amount in bytes. If the memory requested is larger, the system will switch to disk or memory mapped files with a small window.
-1	A special value designed for multi-threaded server operations. The specific number of bytes depends on the processor(s) being used as follows:
	For x86 processors, the value is 42,187,000 (42MBytes).
	For x64 processors, the value is calculated dynamically (1.7GBytes for each 8 cores, not exceeding the physical memory size).
	All other values are currently invalid.