LTwain::BitmapCallBack

#include "ltwrappr.h"

virtual L_INT LTwain::BitmapCallBack (pBitmap)

pBITMAPHANDLE pBitmap;

/* pointer to the bitmap handle */

Handles each image provided by the calling function LTwain::Acquire.

Parameter

Description

pBitmap

Pointer to the bitmap handle that references the bitmap acquired from the TWAIN source. It is the same bitmap handle that you specify when calling the LTwain::Acquire function.

Returns

SUCCESS

The function was successful.

SUCCESS_ABORT

The callback wants to abort the scanning operation.

< 1

An error occurred. Refer to Return Codes.

Comments

This callback function will be enabled only if you enabled the callback functions by calling LBase::EnableCallBack(TRUE). You must handle the image during this callback.

To prevent memory leaks, the user should free the bitmap within the callback function.

The LTwain::GetExtendedImageInfo function can only be called within LTwain::BitmapCallBack.

Required DLLs and Libraries

LTTWN

For a listing of the exact DLLs and Libraries needed, based on the toolkit version, refer to Files To Be Included With Your Application.

See Also

Functions:

LTwain::Acquire, LTwain::GetExtendedImageInfo

Topics:

TWAIN Functionality: Callback Functions.

Example

For an example, refer to LTwain::Acquire.