L_WiaAcquireSimple

#include "ltwia.h"

L_LTWIA_API L_INT EXT_FUNCTION L_WiaAcquireSimple(uWiaVersion, hWndParent, uDeviceType, uFlags, pSourceItem, pAcquireOptions, pnFilesCount, pppszFilePaths, pfnCallBack, pUserData)

Acquires one or more images from a WIA source.

Returns

Comments

This feature is available in version 16 or higher.

This is a high level acquire function that you can call directly. When using this function, the following functions are called internally:

L_WiaInitSession

L_WiaSelectDeviceDlg

L_WiaEndSession

You can let this method do either memory transfer or file transfer by doing one of the following:

• Set the transfer mode you wish to use through the LWIAPROPERTIES structure and pass it to the L_WiaSetProperties method.

• Set the transfer mode by calling the low level method L_WiaSetPropertyLong passing WIA_IPA_TYMED for the uID member of this method and transfe mode you wish to use (TYMED_CALLBACK or TYMED_FILE) for the lValue member.

When performing memory transfer you need to provide a callback pointer to receive the acquired page(s). Use the pBitmap parameter of the callback. The callback will also provide you with the percent completion of the page transfer progress.

When performing file transfers it is optional to provide a callback pointer, since the callback will only provide the saved file path and the percent completion of the file save process.

To cancel the acquire operation provide a pointer to the LWIAACQUIRECALLBACK callback and return the ERROR_USER_ABORT error code.

So if the user wants to keep his changed properties then he should not set this flag to suppress the manufacturer's image acquisition dialog and acquire directly from the specified source item.

Required DLLs and Libraries

Platforms

LEADTOOLS WIA supports both 32-bit and 64-bit image acquisition for both WIA 1.0 (XP and earlier) and WIA 2.0 (VISTA and later).

static L_INT CALLBACK WiaAcquireSimpleCB(HWIASESSION hSession, 
pBITMAPHANDLE pBitmap, 
L_TCHAR * pszFilename, 
L_UINT32 uPercent, 
L_UINT32 uFlags, 
L_VOID * pUserData) 
{ 
   UNREFERENCED_PARAMETER(hSession); 
   UNREFERENCED_PARAMETER(pBitmap); 
   UNREFERENCED_PARAMETER(pszFilename); 
   UNREFERENCED_PARAMETER(uPercent); 
   UNREFERENCED_PARAMETER(uFlags); 
   UNREFERENCED_PARAMETER(pUserData); 
   // You can do here any processing to the bitmap. 
   return WIA_SUCCESS; 
} 
L_INT WiaAcquireSimpleExample(L_UINT uWiaVersion, HWND hWnd) 
{ 
   L_INT nRet; 
   LWIAACQUIREOPTIONS AcquireOpts; 
   L_UINT uFlags; 
   uFlags = L_WIA_SELECT_DEVICE_NODEFAULT | L_WIA_SHOW_USER_INTERFACE | L_WIA_DEVICE_DIALOG_USE_COMMON_UI; 
   /* Initialize and fill the required fields from the LWIAACQUIREOPTIONS structure */ 
   memset(&AcquireOpts, 0, sizeof(LWIAACQUIREOPTIONS)); 
   AcquireOpts.uStructSize = sizeof(LWIAACQUIREOPTIONS); 
   AcquireOpts.bDoubleBuffer = TRUE; 
   AcquireOpts.uMemBufSize = 64 * 1024; 
   nRet = L_WiaAcquireSimple(uWiaVersion, 
   hWnd, 
   WiaDeviceTypeDefault, 
   uFlags, 
   NULL, 
   &AcquireOpts, 
   NULL, 
   NULL, 
   WiaAcquireSimpleCB, 
   NULL); 
   if(nRet != WIA_SUCCESS) 
      return nRet; 
   return SUCCESS; 
}