L_GetMemoryThresholds

#include "l_bitmap.h"

L_LTKRN_API L_VOID L_GetMemoryThresholds(pnTiledThreshold, pnMaxConvSize, pnTileSize, pnConvTiles, pnConvBuffers);

L_INT* pnTiledThreshold;	pointer to a variable to be updated with the tiled threshold
L_SSIZE_T* pnMaxConvSize;	pointer to a variable to be updated with the maximum size for conventional memory
L_SSIZE_T* pnTileSize;	pointer to a variable to be updated with the tile size
L_INT* pnConvTiles;	pointer to a variable to be updated with the maximum number of conventional tiles
L_INT* pnConvBuffers;	pointer to a variable to be updated with the number of buffers in conventional memory

Gets the current memory restrictions set using L_SetMemoryThresholds.

Parameter	Description
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 L_SetMemoryThresholds.
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 L_SetMemoryThresholds.
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 L_SetMemoryThresholds.
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 L_SetMemoryThresholds.
pnConvBuffers	Pointer to a variable to be updated with the number of buffers in conventional memory. For more information, refer to L_SetMemoryThresholds.

Comments

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

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

Returns

None.

Required DLLs and Libraries

LTKRN

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, Linux.

Example

This example doubles the maximum size for a conventional bitmap.

L_INT GetMemoryThresholdsExample(L_VOID) 
{ 
   L_INT nRet; 
   L_SSIZE_T zMaxConvSize; 
   /* Get only the max conventional size value */ 
   L_GetMemoryThresholds (NULL, &zMaxConvSize, NULL, NULL, NULL); 
   /* Double the max conventional size value */ 
   nRet = L_SetMemoryThresholds (0, zMaxConvSize * 2, 0, 0, 0, MEM_MAXCONVSIZE); 
   if(nRet != SUCCESS) 
      return nRet; 
   return SUCCESS; 
}

Help Version 19.0.2017.10.27

Products | Support | Contact Us | Copyright Notices
© 1991-2017 LEAD Technologies, Inc. All Rights Reserved.

LEADTOOLS Raster Imaging C API Help

Introduction

Version History

Getting Started

LEADTOOLS Raster Imaging Features

Redistributables/Files To Be Included With Your Application

Functions:	L_SetMemoryThresholds, L_GetBitmapMemoryInfo, L_SetBitmapMemoryInfo, L_SetTempDirectory, L_GetTempDirectory
Topics:	Memory Storage Types for Bitmaps
	Raster Image Functions: Creating and Deleting Images