From 48263b8f3b7f6dd031679463bd8f4da29440328d Mon Sep 17 00:00:00 2001
From: Eugene Wang <8755753+soukoku@users.noreply.github.com>
Date: Mon, 2 Feb 2026 22:50:19 -0500
Subject: [PATCH] Better error handling in transfer file image routine.

---
 src/NTwain/TransferLoopThread.Logic.cs | 9 ++++++++-
 1 file changed, 8 insertions(+), 1 deletion(-)

diff --git a/src/NTwain/TransferLoopThread.Logic.cs b/src/NTwain/TransferLoopThread.Logic.cs
index 8835bfc..5370f08 100644
--- a/src/NTwain/TransferLoopThread.Logic.cs
+++ b/src/NTwain/TransferLoopThread.Logic.cs
@@ -382,7 +382,14 @@ partial class TransferLoopThread
             }
             else
             {
-                Debugger.Break();
+                if (Debugger.IsAttached) Debugger.Break();
+
+                _twain.Logger.LogWarning(
+                    "TransferFileImage failed unexpectedly: RC={RC}, CC={CC}",
+                    sts.RC, sts.ConditionCode);
+
+                // Or raise error event for user to handle
+                _twain.RaiseTransferError(new TransferErrorEventArgs(sts, "TransferFileImage"));
             }
         }
         return sts;