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 [僅限傳統型應用程式] |
標頭 |
|
Idl |
|