L_SetBitmapMemoryInfo
#include "l_bitmap.h"
L_LTKRN_API L_INT L_SetBitmapMemoryInfo(pBitmap, uMemory, uTileSize, uTotalTiles, uConvTiles, uMaxTileViews, uTileViews, uFlags)
pBITMAPHANDLE pBitmap; |
/* pointer to the bitmap handle */ |
L_UINT uMemory; |
/* memory type to set */ |
L_SSIZE_T uTileSize; |
/* tile size to set */ |
L_UINT uTotalTiles; |
/* number of tiles to set */ |
L_UINT uConvTiles; |
/* number of conventional tiles to set */ |
L_UINT uMaxTileViews; |
/* maximum number of disk tile views to set */ |
L_UINT uTileViews; |
/* number of actual disk tile views to set */ |
L_UINT uFlags; |
/* flags that indicate which parameters are valid */ |
Sets the bitmap allocation parameters.
Parameter |
Description |
|
pBitmap |
Pointer to the bitmap handle that references the bitmap for which to set the allocation parameters. It cannot be NULL and it must be allocated. |
|
uMemory |
Value that represents the new memory type for the bitmap. This parameter is used only if SETMEM_MEMORY is set in uFlags. |
|
uTileSize |
Value that represents the new size for the tile. This parameter is used only if SETMEM_TILESIZE is set in uFlags. |
|
uTotalTiles |
Value that represents the new number of tiles. This parameter is used only if SETMEM_TOTALTILES is set in uFlags. |
|
uConvTiles |
Value that represents the new number of conventional tiles. This parameter is used only if SETMEM_CONVTILES is set in uFlags. |
|
uMaxTileViews |
Value that represents the new maximum number of swap buffers for the disk tiles. This parameter is used only if SETMEM_MAXTILEVIEWS is set in uFlags. |
|
uTileViews |
Value that represents the new number of swap buffers for the disk tiles. This parameter is used only if SETMEM_TILEVIEWS is set in uFlags. |
|
uFlags |
Flags that indicate which parameters should be considered valid. Possible values are one or an OR-ed combination of the following: |
|
|
Value |
Meaning |
|
SETMEM_MEMORY |
[0x0001] uMemory is valid |
|
SETMEM_TILESIZE |
[0x0002] uTileSize is valid |
|
SETMEM_TOTALTILES |
[0x0004] uTotalTiles is valid |
|
SETMEM_CONVTILES |
[0x0008] uConvTiles is valid |
|
SETMEM_MAXTILEVIEWS |
[0x0010] uMaxTileViews is valid |
|
SETMEM_TILEVIEWS |
[0x0020] uTileViews is valid |
Comment
If uMemory is valid and is not TYPE_TILED, then the other parameters are ignored. If uMemory is not valid and the bitmap is not tiled, then the other parameters are ignored. This overrides the uFlags parameter.
Returns
SUCCESS |
The function was successful. |
< 1 |
An error occurred. Refer to Return Codes. |
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
Windows 2000 / XP/Vista, Windows CE.
See Also
Functions: |
L_SetMemoryThresholds, L_GetMemoryThresholds, L_GetBitmapMemoryInfo, L_SetTempDirectory, L_GetTempDirectory |
Topics: |
|
|
Example
L_INT SetBitmapMemoryInfoExample(pBITMAPHANDLE pBitmap) { L_INT nRet; // change the tiled bitmap so is can use as many cache buffers as possible: nRet = L_SetBitmapMemoryInfo(pBitmap, 0, // uMemory 0, // uTileSize 0, // uTotalTiles 0, // uConvTiles (L_UINT)-1, // uMaxTileViews, (L_UINT)-1, // uTileViews, SETMEM_MAXTILEVIEWS | SETMEM_TILEVIEWS); if(nRet != SUCCESS) return nRet; return SUCCESS; }