IWiaItem2::D eviceDlg メソッド

  • [アーティクル]

イメージの取得を準備するためのダイアログ ボックスをユーザーに表示します。

構文

HRESULT DeviceDlg(
  [in]      LONG      lFlags,
  [in]      HWND      hwndParent,
  [in]      BSTR      bstrFolderName,
  [in]      BSTR      bstrFilename,
  [in]      LONG      *plNumFiles,
  [in, out] BSTR      **ppbstrFilePaths,
  [in, out] IWiaItem2 **ppIWiaItem2
);

パラメーター

lFlags [in]

型: LONG

ダイアログ ボックスの操作を制御するフラグのセットを指定します。 値には、既定の動作を表す 0、または WiaFlag で説明されているWIA_DEVICE_DIALOGフラグのいずれかを指定できます。

hwndParent [in]

型: HWND

親ウィンドウへのハンドル。

bstrFolderName [in]

種類: BSTR

ファイルを転送するフォルダー名を指定します。

bstrFilename [in]

種類: BSTR

テンプレート ファイル名を指定します。

plNumFiles [in]

型: LONG*

ppbstrFilePaths 配列内の項目数へのポインター。

ppbstrFilePaths [in, out]

種類: BSTR**

スキャンされたファイルのパスの配列へのポインターのアドレス。 IWiaItem2::D eviceDlg が呼び出される前に、サイズ 0 の配列を指すポインターを初期化します。

ppIWiaItem2 [in, out]

種類: IWiaItem2**

IWiaItem2 インターフェイスへのポインターの配列のアドレス。

戻り値

型: HRESULT

このメソッドが成功すると、 S_OKが返されます。 それ以外の場合は、 HRESULT エラー コードが返されます。

注釈

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

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

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

要件

要件 値
サポートされている最小のクライアント
 Windows Vista [デスクトップ アプリのみ]
サポートされている最小のサーバー
 Windows Server 2008 [デスクトップ アプリのみ]
Header
Wia.h
IDL
Wia.idl