共用方式為


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 () 0 的陣列指標。

ppIWiaItem2 [in, out]

類型: IWiaItem2**

IWiaItem2介面指標陣列的位址。

傳回值

類型: HRESULT

如果此方法成功,則會傳回 S_OK。 否則,它會傳回 HRESULT 錯誤碼。

備註

這個方法會向使用者顯示對話方塊,讓應用程式用來收集影像擷取所需的所有資訊。 它也可用來指定影像掃描屬性,例如亮度和對比。

這個方法傳回之後,應用程式可以使用 IWiaTransfer 介面來取得影像。

應用程式必須針對它們透過ppIWiaItem2參數收到的介面指標陣列中的每個元素呼叫IUnknown::Release方法。 應用程式也必須使用 CoTaskMemFree釋放陣列。

規格需求

需求
最低支援的用戶端
Windows Vista [僅限傳統型應用程式]
最低支援的伺服器
Windows Server 2008 [僅限傳統型應用程式]
標頭
Wia.h
Idl
Wia.idl