DTWAIN_GetNumAcquisitions
|
The DTWAIN_GetNumAcquisitions returns the number of acquisitions that were attempted by the Source when acquiring images.
LONG DTWAIN_GetNumAcquisition ( DTWAIN_ARRAY AcqArray );
Parameters AcqArray The DTWAIN_ARRAY that is returned from a DTWAIN Acquisition function.
Return Values If the function succeeds, the number of acquisitions attempted by the Source. If unsuccessful, the return value is a negative number denoting the error code.
Comments The DTWAIN_GetNumAcquisitions function returns the number of acquisitions attempted by the Source Source
Note that the number of acquisitions is not the number of pages acquired. It is the number of times the user (or program) requests that a set of documents should be acquired (e.g. the number of times the user pressed the "Scan" button on the Source's user interface). Thus a single acquisition could consist of multiple pages (for example, a device with a document feeder that scans multiple pages). To retrieive the number of pages acquired for each acquisition, use DTWAIN_GetNumAcquiredImages. For more information on how DTWAIN stores acquired images, see the following topics: DTWAIN Modal Acquisition Processing DTWAIN Modeless Acquisition Processing
TWAIN State Transitions None
Prerequisite Function Call(s) DTWAIN Source Selection Function DTWAIN Acquisition Function (DTWAIN_AcquireNative or DTWAIN_AcquireBuffered)
See Also |