DTWAIN_EnableAutoFeed

Top  Previous  Next

The DTWAIN_EnableAutoFeed function determines whether the document feeder will be used to acquire images.

 

DTWAIN_BOOL DTWAIN_EnableAutoFeed (

DTWAIN_SOURCE

Source

DTWAIN_BOOL

bEnable );

 

Parameters

Source

An open TWAIN Source.

 

bEnable

Determines whether to turn on or off the automatic feeding function of the document feeder.

 

Return Values

The return value is TRUE if successful.  Otherwise FALSE is returned.

 

Comments

The DTWAIN_EnableAutoFeed function determines whether to use the document feeder's automatic feeding functions.  Before calling DTWAIN_EnableAutoFeed, you must call DTWAIN_EnableFeeder with a TRUE argument.  

 

If bEnable is TRUE, the automatic feeding capabilities of the document feeder is used.  If bEnable is FALSE, the automatic feeding capabilities are turned off, and the application is responsible for controlling the feeding of pages by calling DTWAIN_FeedPage, DTWAIN_RewindPage, or DTWAIN_ClearPage.  By default, the auto-feed is always set to TRUE when acquiring pages using the document feeder.

 

DTWAIN_EnableAutoFeed is usually not called, since most applications that use the document feeder to acquire pages use the automatic feeding method.  However, if your application requires special handling of feeding pages, disabling the auto-feed mechanism is the only alternative.  Before deciding whether your application should turn off the automatic feeder, you should determine whether DTWAIN_FeedPage, DTWAIN_ClearPage, and/or DTWAIN_RewindPage can be executed. Many Sources do not allow an application to control the feeder, and auto-feed mode is the only option..

 

TWAIN State Transitions

The Source must be in State 4 or higher

 

Prerequisite Function Call(s)

DTWAIN_SysInitialize

DTWAIN Source Selection Function

DTWAIN_EnableFeeder (with bEnable = TRUE)

 

See Also

Automatic Document Feeder Support