ISISCALLBACK Function

#include "l_bitmap.h"

L_INT pEXT_CALLBACK YourFunction(pBitmap, nPage, pszFileName, pUserData)

pBITMAPHANDLE pBitmap;

/* pointer to the bitmap handle */

L_INT32 nPage;

/* page number */

L_CHAR L_FAR *pszFileName;

/* filename */

L_VOID L_FAR *pUserData;

/* pointer to additional parameters */

Callback function called after each page is acquired from the ISIS Scanner Driver. This function is available in Document/Medical toolkits only.

Parameter

Description

pBitmap

The pointer to the bitmap handle referencing the bitmap that contains the image.

nPage

Number of the page just acquired

pszFileName

Character string containing the name of the file saved

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 the calling function.

 

Keep in mind that this is a void pointer, which must be cast to the appropriate data type within your callback function.

Returns

SUCCESS

The function was successful, continue scanning

< 1

An error occurred. Refer to Return Codes and cancel scanning.

Comments

Refer to L_SetLoadInfoCallback for a description of how this type of callback function is used. For general information on using ISIS, refer to Using Isis to Scan Images.

Example

For an example, refer to L_ISISAcquireMulti.