LTwain::GetExtendedImageInfo

#include "ltwrappr.h"

virtual L_INT LTwain::GetExtendedImageInfo(ptwExtImgInfo)

TW_EXTIMAGEINFO * ptwExtImgInfo;

/* pointer to a structure */

Gets the extended image information related to the image acquired by the LTwain::Acquire function.

Parameter	Description
ptwExtImgInfo	Pointer to a TW_EXTIMAGEINFO structure that references extended image info to fill.

Returns

SUCCESS	The function was successful.
< 1	An error occurred. Refer to Return Codes.

Comments

This function can only be called during the LTwain::BitmapCallBack function, called by the LTwain::Acquire function, and only after a page has been acquired from a TWAIN source.

Extended image information can be Barcode texts, Barcode data, etc. For more information on extended image information, refer to the Twain 1.9 Specification, available at www.twain.org.

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::BitmapCallBack, LTwain::InitSession, LTwain::EndSession.
Topics:	How to Acquire from the TWAIN Source
	TWAIN Functionality: Extended Image Information Functions.

Example

class CMyTwain : public LTwain
{
public:
   L_INT BitmapCallBack(pBITMAPHANDLE pBitmap);
};

// This function will be called if you call LTwain::Acquire function
L_INT CMyTwain::BitmapCallBack(pBITMAPHANDLE pBitmap)
{
   L_INT nRet = SUCCESS;
   TW_EXTIMAGEINFO * pExtImg = NULL;

   pExtImg = (TW_EXTIMAGEINFO *)GlobalAllocPtr (GHND, sizeof (TW_EXTIMAGEINFO) + sizeof(TW_INFO));
   if (pExtImg)
   {
      pExtImg->NumInfos = 2;
      pExtImg->Info[1].InfoID = TWEI_BARCODECOUNT;
      pExtImg->Info[1].ItemType = TWTY_UINT32;
      pExtImg->Info[1].InfoID = TWEI_BARCODETYPE;
      pExtImg->Info[1].ItemType = TWTY_UINT32;

      if (GetExtendedImageInfo (pExtImg) == SUCCESS)
      {
         // Do processing to returned values
         FreeExtendedImageInfoStructure(&pExtImg);
      }

      GlobalFreePtr (pExtImg);
   }

   return nRet;

}