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