L_SetBitmapMemoryInfo
#include "l_bitmap.h"
L_INT EXT_FUNCTION 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_UINT 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 95 / 98 / Me, Windows 2000 / XP, Windows CE.
See Also
|
Functions: |
L_SetMemoryThresholds, L_GetMemoryThresholds, L_GetBitmapMemoryInfo, L_SetTempDirectory, L_GetTempDirectory |
|
Topics: |
|
|
|
Example
// change the tiled bitmap so is can use as many cache buffers as possible:
BITMAPHANDLE Bitmap;
L_SetBitmapMemoryInfo(
&Bitmap,
0, // uMemory
0, // uTileSize
0, // uTotalTiles
0, // uConvTiles
(L_UINT)-1, // uMaxTileViews,
(L_UINT)-1, // uTileViews,
SETMEM_MAXTILEVIEWS | SETMEM_TILEVIEWS
);