DTWAIN_EnumExtendedCaps

Top  Previous  Next

The DTWAIN_EnumExtendedCaps function fills a DTWAIN_ARRAY with all of a Source's supported extended device capabilities.

 

DTWAIN_BOOL DTWAIN_EnumExtendedCaps (

DTWAIN_SOURCE

Source,

LPDTWAIN_ARRAY

Array );

 

Parameters

Source

Specifies an open TWAIN Source.

 

Array

A pointer to a DTWAIN_ARRAY that will contain the capabilities retrieved.

 

Return Values

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

 

Comments

The DTWAIN_EnumExtendedCaps function fills the DTWAIN_ARRAY pointed to by Array with all of the extended device capabilities supported by the Source Source that are negotiated during TWAIN State 5and State 6.  An extended capability is one that is negotiated when the Source is ready to acquire (State 5) or is acquiring images (State 6).  For example, one of these capabilities include DTWAIN_CV_CAPFEEDPAGE which ejects a page from the device before proceed to acquire the next page.  For this type of action to work, the capability must be negotiated while DTWAIN is acquiring an image.

 

If the return value for DTWAIN_EnumExtendedCaps is FALSE, the Source may not support querying for extended capabilities  The DTWAIN_ARRAY type that is used is to store the capability constants is DTWAIN_ARRAYLONG.

 

Note that the Source should be an opened Source.

 

TWAIN State Transitions

The source must be opened in State 4

 

Prerequisite Function Call(s)

DTWAIN_SysInitialize

 

DTWAIN Source Selection Function

 

 

See Also

Setting / Getting Twain Capabilities