In This Topic ▼

LMemoryFile::GetMemoryThresholds

Summary

Gets the current memory restrictions set using LMemoryFile::SetMemoryThresholds.

Syntax

#include "ltwrappr.h"

static L_VOID LMemoryFile::GetMemoryThresholds(pnTiledThreshold, pnMaxConvSize, pnTileSize, pnConvTiles, pnConvBuffers)

Parameters

L_INT * pnTiledThreshold

Pointer to a variable to be updated with a value that represents the minimum amount of free memory required to allow the allocation of conventional bitmaps. For more information, refer to LMemoryFile::SetMemoryThresholds.

L_SSIZE_T * pnMaxConvSize

Pointer to a variable to be updated with a value that represents the maximum size for a conventional bitmap. For more information, refer to LMemoryFile::SetMemoryThresholds.

L_SSIZE_T * pnTileSize

Pointer to a variable to be updated with a value that represents the size of the tile for tiled bitmaps. For more information, refer to LMemoryFile::SetMemoryThresholds.

L_INT * pnConvTiles

Pointer to a variable to be updated with a value that represents the maximum number of tiles that will reside in conventional memory at any time. For more information, refer to LMemoryFile::SetMemoryThresholds.

L_INT * pnConvBuffers

Pointer to a variable to be updated with the number of buffers in conventional memory. For more information, refer to LMemoryFile::SetMemoryThresholds.

Returns

None.

Comments

This function will allow you to retrieve the parameters set with LMemoryFile::SetMemoryThresholds. For more information on the various thresholds, refer to LMemoryFile::SetMemoryThresholds.

Pass NULL for any parameter you are not interested in retrieving.

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.

Example

This example doubles the maximum size for a conventional bitmap.

L_INT LMemoryFile__GetMemoryThresholdsExample() 
{ 
   L_INT nRet; 
   L_SSIZE_T nMaxConvSize;  
 
   /* Get only the max conventional size value */ 
   LMemoryFile::GetMemoryThresholds (NULL, &nMaxConvSize, NULL, NULL, NULL);  
 
   /* Double the max conventional size value */ 
   nRet = LMemoryFile::SetMemoryThresholds(0, (L_INT) nMaxConvSize * 2, 0, 0, 0, MEM_MAXCONVSIZE); 
   if(nRet != SUCCESS) 
      return nRet; 
 
   return SUCCESS; 
}