L_AccessBitmap

#include "l_bitmap.h"

L_VOID EXT_FUNCTION L_AccessBitmap(pBitmap)

pBITMAPHANDLE pBitmap;

/* pointer to the bitmap handle */

Provides exclusive access to the image data contained in a bitmap handle.

Parameter

Description

pBitmap

Pointer to the bitmap handle that references the bitmap to lock.

Returns

None.

Comments

This call locks the memory. If you do not call this function before accessing the data with a low-level function such as L_GetBitmapRow or L_PutBitmapRow, the application will fail.

To make the most of available system resources, you should only keep a bitmap handle locked when you need to access the image data. Call L_ReleaseBitmap to unlock the bitmap data for more efficient use of Windows memory resources.

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_ReleaseBitmap, 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 GETROW example.