IWiaDevMgr2：：SelectDeviceDlgID 方法
顯示一個對話方塊，讓使用者選取硬體裝置以進行影像擷取。
語法
HRESULT SelectDeviceDlgID(
[in] HWND hwndParent,
[in] LONG lDeviceType,
[in] LONG lFlags,
[out, retval] BSTR *pbstrDeviceID
);
參數
-
hwndParent [in]
-
類型： HWND
指定 [ 選取裝置 ] 對話方塊的父視窗。
-
lDeviceType [in]
-
類型： LONG
指定要使用的 WIA 2.0 裝置類型。 如需可能值的清單，請參閱 WIA 裝置類型規範 。
-
lFlags [in]
-
類型： LONG
指定對話方塊的行為。 此值可以是下列其中一項。
-
0
-
使用預設行為。
-
WIA_SELECT_DEVICE_NODEFAULT
-
即使只有一個相符的裝置，仍會顯示對話方塊。
pbstrDeviceID [out， retval]
類型： BSTR*
接收裝置識別碼字串之字串的指標。
傳回值
類型： HRESULT
這個方法可以傳回其中一個值。
| 傳回碼 | 描述 |
|---|---|
|
已成功選取裝置。 |
|
使用者已取消對話方塊。 |
|
沒有 WIA 2.0 硬體裝置符合 lDeviceType 參數中指定的規格。 |
備註
此方法會建立並顯示 [ 選取裝置 ] 對話方塊，讓使用者可以選取 WIA 2.0 裝置進行影像擷取。 如果已成功選取裝置， IWiaDevMgr2：：SelectDeviceDlgID 方法會透過 其 pbstrDeviceID 參數將其識別碼字串傳遞至應用程式。
應用程式可以透過 lDeviceType 參數指定裝置類型，將向使用者顯示的裝置限制為特定類型。 如果只有一部裝置符合規格， IWiaDevMgr2：：SelectDeviceDlgID 不會顯示 [ 選取裝置 ] 對話方塊。 相反地，它會將裝置的識別碼字串傳遞至應用程式，而不會顯示對話方塊。 您可以覆寫此行為，並強制 IWiaDevMgr2：：SelectDeviceDlgID 傳遞WIA_SELECT_DEVICE_NODEFAULT做為 lFlags 參數的值來顯示對話方塊。 如果多個 WIA 2.0 裝置符合規格，所有相符的裝置都會顯示在 [SelectDevice] 對話方塊中，讓使用者可以選擇一個。
注意
建議應用程式透過 [檔案] 功能表上名為[從掃描器] 的功能表項目，來選取裝置和影像。
規格需求
| 需求 | 值 |
|---|---|
| 最低支援的用戶端 |
Windows Vista [僅限傳統型應用程式] |
| 最低支援的伺服器 |
Windows Server 2008 [僅限傳統型應用程式] |
| 標頭 |
|
| Idl |
|