DTWAIN_EnableMsgNotify

The DTWAIN_EnableMsgNotify function enables or disables DTWAIN Notification messaging.

DTWAIN_BOOL DTWAIN_EnableMsgNotify ( DTWAIN_BOOL bEnable );

Parameters

bEnable

A Determines whether DTWAIN notifications are enabled or disabled.

Return Values

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

Comments

The DTWAIN_EnableMsgNotify allows the application to capture DTWAIN messages during image acquisition.  During image acquisition, DTWAIN can inform your application of the progress of the acquisition by sending a message as well as a notification code to your application's DTWAIN message window, or to the callback function specified by DTWAIN_SetCallback.  The message window is the window specified in the HWND parameter of the DTWAIN_StartTwainSession function.

If bSet is TRUE, the message window or callback function will be able to capture the DTWAIN notifications.  If bSet is FALSE, message notification to the message window or callback function is disabled.  By default, message notification is disabled.  To check if message notification is enabled or disabled, call DTWAIN_IsMsgNotifyEnabled function.

If notifications are disabled and your application still attempts to process DTWAIN notifications, the application may become unstable when acquiring images.  This is the reason why it is extremely important to set the DTWAIN_EnableMsgNotify to TRUE if DTWAIN processing is done.

TWAIN State Transitions

None

Prerequisite Function Call(s)

DTWAIN_SysInitialize