Acquire

#include "BiTwain.h"

 

int CALLBACK Acquire(LPCTSTR lpFileName)

Description

This function should be called to start general scanning. The lpFileName parameter will be used as the output file name. If the lpFileName is a NULL pointer the driver will return a DIB (device independent bitmap). When scanning is finished the WM_BI_SCANNING_DOCUMENT_FINISHED message sent. The lParam will contain the pointer to the specified structure.

typedef struct tagstScanningDocumentFinished

{

            HANDLE hDib;

            LPCWSTR lpFileName;

 }stScanningDocumentFinished, *lpstScanningDocumentFinished;

 

hDib contains the handle of the DIB scanned. The lpFileName contains the path and name of  the file or NULL. The user should free the allocated memory for hDib.

Parameters

LPCTSTR

lpFileName

The full path of the output file.

Additional Information

This example shows how to use the dll when loading statically including the header file. Otherwise if the dll is loaded dynamically, for further information read the “About the difference of static and dynamic library loading” section of the manual.

Return values

Return TW_OK on success or an error code on failure.

Requirements

Header :     Declared in BiTwain.h; include BiTwain.h.

Library :    Use BiTwain.lib.

DLLs :       BiTwain.dll.