Data Source Managerを開く(Stateは2 -> 3)
- Data Group: DG_CONTROL
- Data Argument Type: DAT_PARENT
- Message ID: MSG_OPENDSM
デバイスを選択する(Stateは3)
1. Source Managerを使ってダイアログから選択できる
  - Data Group: DG_CONTROL
  - Data Argument Type: DAT_IDENTITY
  - Message ID: MSG_USERSELECT
2. またはSource Managerを使って全件取得し、利用したいものを探す
  - Data Group: DG_CONTROL
  - Data Argument Type: DAT_IDENTITY
  - Message ID: MSG_GETFIRST＆MSG_GETNEXT
Data Sourceを開く(Stateは3 -> 4)
- Data Group: DG_CONTROL
- Data Argument Type: DAT_IDENTITY
- Message ID: MSG_OPENDS
デバイスの機能設定を行う(Stateは4)
- Operation TripletsでValid States=4を利用できる
Data Sourceを有効にする(Stateは4 -> 5)
- デバイスが提供する設定ダイアログを開くことができるし、開かずそのまま進めることもできる
  - Data Group: DG_CONTROL
  - Data Argument Type: DAT_USERINTERFACE
  - Message ID: MSG_ENABLEDS
デバイスから転送を始める(Stateは6 -> 7)
- Data Group: DG_CONTROL
- Data Argument Type: DAT_IMAGExxxxXFER
  - MSG_IMAGENATIVEXFER
  - MSG_IMAGEFILEXFER
  - MSG_IMAGEMEMFILEXFER
  - MSG_IMAGEMEMXFER
- Message ID: MSG_GET
保留中の転送を確認する(Stateは7 -> 6)
- Data Group: DG_CONTROL
- Data Argument Type: DAT_PENDINGXFERS
- Message ID: MSG_ENDXFER

Stateの状態を把握しておけば、下記のサンプルコードを使って思い通りの処理を作れるだろう*1。いつかTWAINを使った実装に関して、ケースバイケースで解説したい。

www.codeproject.com

その他、公式ドキュメントにはたくさんの実装する上で欠かせない情報が掲載されている。

実装のチュートリアルは4章「Advanced Application Implementation」
エントリーポイント定義は6章「Entry Points and Triplet Components」
エントリーポイントを使ってコマンドを実行するときのパラメーター組み合わせは7章「Operation Triplets」

定数定義やデバイス機能設定(Capability)に関しても他の章で扱っている。とにかく困ったら一読することをおすすめする。

*1:WPFで使うならウインドウプロシージャでTWAIN機器からのメッセージを受け取る処理が必要

2022-09-21

BackgroundWorkerでBitmapSourceを扱うときの注意点。

C# ソフトウェア開発技術情報

このオブジェクトは別のスレッドに所有されているため、呼び出しスレッドはこのオブジェクトにアクセスできません。

BackgroundWorker.RunWorkerAsyncの引数にList<BitmapSource>型のリストを渡して、BackgroundWorker.OnDoWorkなどでBitmapSourceを取り出して処理を行う場合、単純に作成したBitmapSourceオブジェクトだと上記のエラーが発生する。

解決策としては、リストに入れる前にBitmapSource.Freezeメソッドを実行する。これでオブジェクトを別スレッドで共有できるようになる。

情報源は以下のスレッド。

stackoverflow.com