WIA_DPS_SCAN_AVAILABLE_ITEM
WIA_DPS_SCAN_AVAILABLE_ITEM プロパティは、アプリケーションがプログラム制御下で実行するプッシュ スキャン操作の入力ソースの名前を提供します。 WIA ミニドライバーは、このプロパティを作成して管理します。
プロパティの型: VT_BSTR
有効な値: WIA_PROP_NONE
アクセス権: 読み取り専用
解説
Windows 7 以降では、WIA_DPS_SCAN_AVAILABLE_ITEM は WIA スキャナー デバイスの WIA 項目ツリーのルート項目のオプション プロパティです。 アプリケーションは、このプロパティに対してクエリを実行して、スキャン元の入力ソース (フラットベッド、自動ドキュメント フィーダー、フィルム スキャン アダプター) またはデータ転送元の格納場所を判断します。
一部の WIA スキャナー デバイスでは、ユーザーがデバイスのフロント パネルからスキャン ジョブの入力ソースを選択したり、デバイスのフィーダーにドキュメントを挿入するなどして、入力ソースを暗黙的に選択したりできます。 ユーザーがデバイスの [スキャンの開始] ボタンを押すと、アプリケーションは、このソースでスキャン操作を開始できるように、ユーザーが選択した入力ソースを判断する必要があります。
スキャン イベントは、ユーザーがスキャンを開始したことをアプリケーションに通知しますが、イベントは入力ソースを表す WIA 項目の名前を提供しません。 アプリケーションのイベント ハンドラーは、ルート項目の WIA_DPS_SCAN_AVAILABLE_ITEM プロパティに対してクエリを実行して、入力ソース項目の名前を取得します。
WIA ツリーのルート項目には、デバイスの入力ソースを表す 1 つ以上の子項目 (フラットベッド項目、フィーダー項目、フィルム項目) があります。 これらの各項目は、入力ソースの部分または領域を表す親から子に渡す項目である場合があります。 ルート項目の子であり、フラットベッド全体を表すフラットベッド項目は、フラットベッドの表面の各領域を表す子 (これもフラットベッド項目) を持つことができます。 ルート項目の子であり、自動ドキュメント フィーダーを表すフィーダー項目は、フィーダーを通過するドキュメント ページの表面と裏面のスキャナーを表す子を持つことができます。 ルート項目の子であり、フィルム スキャン アダプター全体を表すフィルム項目は、各フィルム フレームを表す子 (これもフィルム項目) を持つことができます。 ユーザーが要求したスキャン操作に応じて、WIA_DPS_SCAN_AVAILABLE_ITEM プロパティは、ルートの子であるフラットベッド、フィーダー、またはフィルム項目に名前を付けたり、これらの項目のいずれかの子に名前を付けたりできます。 これらの項目の詳細については、「WIA 項目カテゴリ」を参照してください 。
スキャン イベントが発生すると、ドライバーは直ちに、WIA_DPS_SCAN_AVAILABLE_ITEM プロパティの値を WIA 項目名 (項目の WIA_IPA_ITEM_NAME プロパティによって報告されたとおり) に設定します。この情報が既知の場合、この名前を使用して、スキャン ジョブが使用可能な入力ソースを識別します。 それ以外の場合、入力ソースが不明な場合、ドライバーはプロパティの値を空の文字列に設定します。 アプリケーションがスキャン イベントを使用すると、スキャン イベントの状態がシグナルから非シグナルに変わり、ドライバーは WIA_DPS_SCAN_AVAILABLE_ITEM プロパティの値を空の文字列にリセットします。
このプロパティの詳細については、「スキャン イベントの入力ソースの識別」を参照してください。
要件
ヘッダー: wiadef.h (Wiadef.h を含む)