In This Topic ▼

L_DoubleBufferCreateHandle

Summary

Creates the handle that is used throughout the double buffering.

Syntax

#include "l_bitmap.h"

L_LTDIS_API L_INT L_DoubleBufferCreateHandle(phDoubleBufferHandle)

Parameters

L_HANDLE* phDoubleBufferHandle

Address of the handle that identifies the double buffering process. If successful, phDoubleBufferHandle points to the handle of the double buffering process.

Returns

Value	Meaning
SUCCESS	The function was successful.
< 1	An error occurred. Refer to Return Codes.

Comments

This function is the first step of a double buffering process. Declare a variable of type L_HANDLE, and pass the address of this variable to L_DoubleBufferCreateHandle. If successful, your variable will contain a double buffering handle that will be used throughout the double buffering process. When you are finished with the handle, you must call L_DoubleBufferDestroyHandle.

You may decide to call this function only one time for you application. If your application is MDI, and you want to double buffer several windows simultaneously, you may want to call this function once for each child window. The latter is the technique used in the C API annotation demo (annot32.exe).

For more information, see the topic Minimizing Flicker With Double Buffering.