WIA Driver Error Recovery

There are multiple points in the WIA image acquisition process where software, hardware, or configuration errors can cause unexpected delays, failure messages, or indecipherable hangs. Most of these errors occur at the point where the application requests image data, either for preview or for the full image.

This section describes a mechanism that allows applications and users to gracefully handle these errors and delays, and possibly, to recover from them. It does not address ways to improve error recovery while trying to set or get device properties, or when callback routines into a driver never return, or during other non-transfer related situations.

This section includes:

WIA Error Handling Architecture

WIA Error Handler Cancellation of Modeless Dialogs

WIA Error Handler Return Values

WIA Device Messages

Installing a WIA Error Handling Driver Extension

WIA Error Handling Examples

For information about the WIA error macros, see WIA Diagnostic Log Macros.