Metode IWiaItem2::D eviceDlg

Artikel
06/13/2023

Menampilkan kotak dialog kepada pengguna untuk mempersiapkan akuisisi gambar.

Sintaks

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
);

Parameter

lFlags [in]

Jenis: LONG

Menentukan sekumpulan bendera yang mengontrol operasi kotak dialog. Nilainya dapat berupa 0 untuk mewakili perilaku default atau salah satu bendera WIA_DEVICE_DIALOG yang dijelaskan dalam WiaFlag.

hwndParent [in]

Jenis: HWND

Handel ke jendela induk.

bstrFolderName [in]

Jenis: BSTR

Menentukan nama folder tempat file akan ditransfer.

bstrFilename [in]

Jenis: BSTR

Menentukan nama file templat.

plNumFiles [in]

Jenis: LONG*

Penunjuk ke jumlah item dalam array ppbstrFilePaths .

ppbstrFilePaths [in, out]

Jenis: BSTR**

Alamat penunjuk ke array jalur untuk file yang dipindai. Inisialisasi penunjuk untuk menunjuk ke array ukuran nol (0) sebelum IWiaItem2::D eviceDlg dipanggil.

ppIWiaItem2 [masuk, keluar]

Jenis: IWiaItem2**

Alamat array pointer ke antarmuka IWiaItem2 .

Nilai kembali

Jenis: HRESULT

Jika metode ini berhasil, metode ini mengembalikan S_OK. Jika tidak, kode kesalahan HRESULT akan dikembalikan.

Keterangan

Metode ini menampilkan kotak dialog kepada pengguna yang digunakan aplikasi untuk mengumpulkan semua informasi yang diperlukan untuk akuisisi gambar. Ini juga digunakan untuk menentukan properti pemindaian gambar seperti kecerahan dan kontras.

Setelah metode ini kembali, aplikasi dapat menggunakan antarmuka IWiaTransfer untuk memperoleh gambar.

Aplikasi harus memanggil metode IUnknown::Release untuk setiap elemen dalam array pointer antarmuka yang mereka terima melalui parameter ppIWiaItem2 . Aplikasi juga harus membebaskan array menggunakan CoTaskMemFree.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows Vista [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2008 [hanya aplikasi desktop]
Header	Wia.h
IDL	Wia.idl

Bagikan melalui