IWiaItem::D eviceDlg メソッド (wia_xp.h)

IWiaItem::D eviceDlg メソッドは、イメージの取得を準備するためのダイアログ ボックスをユーザーに表示するために、アプリケーションで使用されます。

構文

HRESULT DeviceDlg(
  [in]  HWND     hwndParent,
  [in]  LONG     lFlags,
  [in]  LONG     lIntent,
  [out] LONG     *plItemCount,
  [out] IWiaItem ***ppIWiaItem
);

パラメーター

[in] hwndParent

型: HWND

ダイアログ ボックスの親ウィンドウのハンドル。

[in] lFlags

型: LONG

ダイアログ ボックスの操作を制御するフラグのセットを指定します。 次のいずれかの値に設定できます。

フラグ	説明
0	既定の動作。
WIA_DEVICE_DIALOG_SINGLE_IMAGE	[デバイス イメージの取得] ダイアログ ボックスで、イメージの選択を 1 つのイメージに制限します。
WIA_DEVICE_DIALOG_USE_COMMON_UI	ベンダー提供の UI ではなく、システム UI (使用可能な場合) を使用します。 システム UI が使用できない場合は、ベンダー UI が使用されます。 どちらの UI も使用できない場合、関数は E_NOTIMPLを返します。

[in] lIntent

型: LONG

イメージが表すデータの種類を指定します。 イメージ インテント値の一覧については、「 Image Intent Constants」を参照してください。

メモ このメソッドは、すべてのWIA_INTENT_IMAGE_* イメージ意図を無視します。

 

[out] plItemCount

型: LONG*

ppIWiaItem パラメーターによって示される配列内の項目の数を受け取ります。

[out] ppIWiaItem

種類: IWiaItem***

IWiaItem インターフェイスへのポインターの配列のアドレスを受け取ります。

戻り値

型: HRESULT

このメソッドは、成功すると S_OK を返します。 そうでない場合は、HRESULT エラー コードを返します。

注釈

このメソッドは、アプリケーションがイメージの取得に必要なすべての情報を収集するために使用するダイアログ ボックスをユーザーに表示します。 たとえば、このダイアログ ボックスを使用すると、ユーザーはカメラからダウンロードする画像を選択できます。 スキャナーを使用する場合は、明るさやコントラストなどの画像スキャン プロパティを指定するためにも使用されます。

このメソッドが戻った後、アプリケーションは IWiaDataTransfer インターフェイスを使用してイメージを取得できます。

アプリケーションは、ppIWiaItem パラメーターを介して受け取るインターフェイス ポインターの配列内の各要素に対して IUnknown::Release メソッドを呼び出す必要があります。 アプリケーションでは、 CoTaskMemFree を使用して配列を解放する必要もあります。

アプリケーションでは、[ファイル] メニューの [スキャナーまたはカメラから] という名前のメニュー項目を使用して、デバイスとイメージの選択を使用できるようにすることをお勧めします。

要件

要件	値
サポートされている最小のクライアント	Windows 2000 Professional、Windows XP [デスクトップ アプリのみ]
サポートされている最小のサーバー	Windows Server 2003 (デスクトップ アプリのみ)
対象プラットフォーム	Windows
ヘッダー	wia_xp.h (Wia.h を含む)
Library	Wiaguid.lib
[DLL]	Wiaservc.dll