Metode IWiaDevMgr2::SelectDeviceDlg

Artikel
06/12/2023

Menampilkan kotak dialog yang memungkinkan pengguna memilih perangkat keras untuk akuisisi gambar.

Sintaks

HRESULT SelectDeviceDlg(
  [in]          HWND      hwndParent,
  [in]          LONG      lDeviceType,
  [in]          LONG      lFlags,
  [in, out]     BSTR      *pbstrDeviceID,
  [out, retval] IWiaItem2 **ppItemRoot
);

Parameter

hwndParent [in]

Jenis: HWND

Menentukan jendela induk dari kotak dialog Pilih Perangkat .

lDeviceType [in]

Jenis: LONG

Menentukan jenis perangkat WIA 2.0 mana yang akan digunakan. Lihat Penentu Jenis Perangkat WIA untuk daftar nilai yang mungkin.

lFlags [in]

Jenis: LONG

Menentukan perilaku kotak dialog. Nilainya bisa menjadi salah satu dari berikut ini.

0

Gunakan perilaku default.

WIA_SELECT_DEVICE_NODEFAULT

Tampilkan kotak dialog meskipun hanya ada satu perangkat yang cocok.

pbstrDeviceID [masuk, keluar]

Jenis: BSTR*

Pada output, menerima string yang berisi string pengidentifikasi perangkat. Pada input, teruskan alamat pointer jika informasi ini diperlukan, atau NULL jika tidak diperlukan.

ppItemRoot [out, retval]

Jenis: IWiaItem2**

Menerima alamat penunjuk ke antarmuka IWiaItem2 dari item akar pohon hierarkis yang mewakili perangkat WIA 2.0 yang dipilih. Jika tidak ada perangkat yang ditemukan, perangkat akan menerima NULL.

Nilai kembali

Jenis: HRESULT

Metode ini dapat mengembalikan salah satu nilai ini.

Menampilkan kode	Deskripsi
S_OK	Perangkat berhasil dipilih.
S_FALSE	Pengguna membatalkan kotak dialog.
WIA_S_NO_DEVICE_AVAILABLE	Tidak ada perangkat keras WIA 2.0 yang cocok dengan spesifikasi yang diberikan dalam parameter lDeviceType .

Keterangan

Metode ini membuat dan menampilkan kotak dialog Pilih Perangkat sehingga pengguna dapat memilih perangkat WIA 2.0 untuk akuisisi gambar. Jika perangkat berhasil dipilih, metode IWiaDevMgr2::SelectDeviceDlg membuat pohon hierarki objek IWiaItem2 untuk perangkat. Ini menyimpan penunjuk ke antarmuka IWiaItem2 dari item akar dalam parameter ppItemRoot.

Aplikasi dapat membatasi perangkat yang ditampilkan kepada pengguna ke jenis tertentu dengan menentukan jenis perangkat melalui parameter lDeviceType . Jika hanya satu perangkat yang memenuhi spesifikasi, IWiaDevMgr2::SelectDeviceDlg tidak menampilkan kotak dialog Pilih Perangkat . Sebaliknya, ia membuat pohon IWiaItem2 untuk perangkat dan menyimpan penunjuk ke antarmuka IWiaItem2 dari item akar dalam parameter ppItemRoot. Anda dapat mengambil alih perilaku ini dan memaksa IWiaDevMgr2::SelectDeviceDlg untuk menampilkan kotak dialog dengan menentukan WIA_SELECT_DEVICE_NODEFAULT sebagai nilai untuk parameter lFlags . Jika lebih dari satu perangkat WIA 2.0 cocok dengan spesifikasi, semua perangkat yang cocok ditampilkan dalam kotak dialog Pilih Perangkat sehingga pengguna dapat memilihnya.

Aplikasi harus memanggil metode IUnknown::Release pada pointer antarmuka yang mereka terima melalui parameter ppItemRoot .

Catatan

Disarankan agar aplikasi membuat pemilihan perangkat dan gambar tersedia melalui item menu bernama Dari pemindai pada menu File .

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

Share via