DTWAIN_InitExtImageInfo

The DTWAIN_InitExtImageInfo starts the process of retrieving the extended image information from the Source.

DTWAIN_BOOL DTWAIN_InitExtImageInfo ( DTWAIN_SOURCE Source );

Parameters

Source

Specifies a TWAIN Source.

Return Values

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

Comments

The DTWAIN_InitExtImageInfo function must be called to set up the Source's retrieval of extended image information.  After the extended image information is retrieved, the DTWAIN_FreeExtImageInfo function must be called.

DTWAIN_InitExtImageInfo must be called when the DTWAIN_TN_TRANSFERDONE notification is sent, therefore only languages that support callback functions or can process window messages can use this function.  If the Source, Source, does not support extended image information, of if DTWAIN_InitExtImageInfo is not called at the time when DTWAIN_TN_TRANSFERDONE is sent, FALSE is returned.

TWAIN State Transitions

The source must be in State 7

Prerequisite Function Call(s)

DTWAIN_SysInitialize

DTWAIN Source Selection Function

DTWAIN Acquisition Function