LTWAINACQUIRECALLBACK

LTWAINACQUIRECALLBACK Function

#include "lttw2.h"

L_VOID pEXT_CALLBACK YourFunction (hSession, nPage, pszFileName, bFinishScan, pUserData)

HTWAINSESSION hSession;	/* handle to an existing TWAIN session */
L_INT nPage;	/* page number */
L_TCHAR L_FAR * pszFileName;	/* File name */
L_BOOL bFinishScan;	/* flag to determine if the scanning status */
L_VOID *pUserData;	/* pointer to additional parameters */

Called twice for each scanned page. The address of this callback is passed as an argument to L_TwainAcquireMulti. This function is available in the Document/Medical Toolkits.

Parameter	Description
hSession	Handle to an existing TWAIN session. This handle is obtained by calling the L_TwainInitSession function.
nPage	Number of the page being acquired
pszFileName	Character string containing the name of the file in which to save the scanned image(s).
bFinishScan	Flag that indicates the scanning status. Possible values are:
	Value	Meaning
	TRUE	Scanning of the page has finished.
	FALSE	Scanning of the page has just started.
pUserData	A void pointer that you can use to access a variable or structure containing data that your callback function needs. This gives you a way to receive data indirectly from the function that uses this callback function. (This is the same pointer that you pass in the pUserData parameter of L_TwainAcquireMulti.)
	Keep in mind that this is a void pointer, which must be cast to the appropriate data type within your callback function

Comments

This callback will be called two times. The callback is called the first time when the Twain source begins scanning the page. The callback is called the second time when the Twain source has finished scanning the page.

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:	L_TwainAcquire, L_TwainAcquireList, L_TwainInitSession, L_TwainEndSession, L_TwainOpenTemplateFile, L_TwainCloseTemplateFile, L_TwainTemplateDlg, L_TwainAddCapabilityToFile, L_TwainGetNumofCapsInFile, L_TwainGetCapabilityFromFile, L_TwainAcquireMulti, L_TwainFindFastConfig, L_TwainGetScanConfigs, L_TwainFreeScanConfig.
Topics:	How to Acquire from the Twain Source
	TWAIN Functionality:Property Functions

Example

For a complete sample, refer to the TWNCONFIG demo

For an example, refer to L_TwainAcquireMulti.