共用方式為

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 在 [裝置影像擷取] 對話框中，將影像選取範圍限製為單一影像。
WIA_DEVICE_DIALOG_USE_COMMON_UI 如果有的話，請使用系統 UI，而不是廠商提供的 UI。 如果系統 UI 無法使用，則會使用廠商 UI。 如果兩個UI都無法使用，函式會傳回E_NOTIMPL。

[in] lIntent

類型： LONG

指定影像要代表的數據類型。 如需影像意圖值的清單，請參閱 影像意圖常數。

注意 此方法會忽略所有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)
程式庫 Wiaguid.lib
Dll Wiaservc.dll