DTWAIN_FreeExtImageInfo

Top  Previous  Next

The DTWAIN_FreetExtImageInfo ends the process of retrieving the extended image information from the Source and removes memory reserved for the extended image information.

 

DTWAIN_BOOL DTWAIN_FreeExtImageInfo ( 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_FreeExtImageInfo function must be called to free any memory reserved for the Source's extended image information.

 

DTWAIN_FreeExtImageInfo 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_FreeExtImageInfo 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 (DTWAIN_TN_TRANSFERDONE notification is sent).

 

Example

 

Prerequisite Function Call(s)

DTWAIN_SysInitialize

DTWAIN Source Selection Function

DTWAIN Acquisition Function

DTWAIN_InitExtImageInfo