DTWAIN_FeedPage

Top  Previous  Next

The DTWAIN_FeedPage function allows an application to eject the current page in the feeder and feed the next page in to the document feeder

 

DTWAIN_BOOL DTWAIN_FeedPage ( DTWAIN_SOURCE Source );

 

 

Parameters

Source

Specifies an open TWAIN Source.

 

Return Values

If the function succeeds, TRUE is returned.  If the function fails FALSE is returned.

 

Comments

The DTWAIN_FeedPage function ejects the current page from the feeder and feeds the next page into the input area of the document feeder

 

If an application decides to control the document feeding process, DTWAIN_FeedPage allows the application to feed the pages without using the auto-feed mode.

 

For DTWAIN_FeedPage to be successful, all of the following items must be true:

 

The Source supports a document feeder (call DTWAIN_IsFeederSupported)

The application has enabled the feeder (call DTWAIN_EnableFeeder)

The Source supports the DTWAIN_CV_CAPFEEDPAGE capability (call DTWAIN_IsCapSupported)

The application has turned off the auto feed (call DTWAIN_EnableAutoFeed with a FALSE argument) before the acquisition process has started.

The application calls DTWAIN_FeedPage during the process of acquiring.

 

For the last item listed above, calling DTWAIN_FeedPage can only be invoked if the application is using DTWAIN Notifications, and has intercepted the DTWAIN_TN_TRANSFERSTRIPREADY, DTWAIN_TN_TRANSFERSTRIPDONE, or DTWAIN_TN_TRANSFERDONE notifications.  Only at these designated times should DTWAIN_FeedPage be called by the application.

 

Application control of the document feeder is best done using buffered memory transfers (DTWAIN_AcquireBuffered).

 

 

TWAIN State Transitions

None.

 

Prerequisite Function Call(s)

DTWAIN_SysInitialize

 

DTWAIN Source Selection Function

DTWAIN_EnableFeeder

DTWAIN_EnableAutoFeed (with bEnable = FALSE)

A DTWAIN Acquisition Function (preferrably DTWAIN_AcquireBuffered).

 

See Also

Automatic Document Feeder Support