DTWAIN_GetNumAcquiredImages

Top  Previous  Next

The DTWAIN_GetNumAcquiredImages returns the number of pages that were acquired by the Source.

 

LONG DTWAIN_GetNumAcquiredImages (

DTWAIN_ARRAY

AcqArray,

LONG

AcquireNum );

 

Parameters

AcqArray

The DTWAIN_ARRAY that is returned from a DTWAIN Acquisition function.

 

AcquireNum

Specifies the Acquisition number.

 

Return Values

If the function succeeds, the number of images acquired.  If unsuccessful, the return value is a negative number denoting the error code.

 

Comments

The DTWAIN_GetNumAcquiredImages function returns the number of images acquired from the Source Source for acquisition number AcquireNum. For most acquisitions, the images are Device Independent Bitmaps (DIBs).  For buffered acquisitions using compression, the image data that is returned describes the raw data bytes of the image (for example, a TIFF file, JPEG file, etc.).

 

Acquisition numbers are numbered from 0 to n-1 where n is the total number of attempted acquisitions.

 

For more information on how DTWAIN stores acquired images, see the following topics:

DTWAIN Modal Acquisition Processing

DTWAIN Modeless Acquisition Processing

DTWAIN_GetAcquiredImage

 

TWAIN State Transitions

None

 

Prerequisite Function Call(s)

DTWAIN_SysInitialize

DTWAIN Source Selection Function

DTWAIN Acquisition Function (DTWAIN_AcquireNative or DTWAIN_AcquireBuffered)

 

See Also

Acquiring Images