L_ReleaseBitmap

#include "l_bitmap.h"

L_LTKRN_API L_VOID L_ReleaseBitmap(pBitmap)

pBITMAPHANDLE pBitmap;

/* pointer to the bitmap handle */

Releases memory back to Windows, reversing the action of the L_AccessBitmap function. This has the same effect as the Windows API GlobalUnlock function.

Parameter

Description

pBitmap

Pointer to the bitmap handle referencing the bitmap to be released.

Returns

None.

Comments

Use this along with the L_AccessBitmap function to control the access to bitmap data in memory. Any attempt to access the image data after calling L_ReleaseBitmap will result in an application error.

You should call this function whenever the image is not used, so that Windows can manage its memory properly.

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_AccessBitmap, L_ClearBitmap, L_GetBitmapRow, L_PutBitmapRow, L_GetBitmapRowCol, L_PutBitmapRowCol, L_GetPixelColor, L_PutPixelColor

Topics:

Raster Image Functions: Getting and Setting Pixel Values

Example

For a short example, refer to L_GetBitmapRow. For complete sample code, refer to the RESIZE example.