IWiaDevMgr2::SelectDeviceDlgID method

Artikel
06/12/2023

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

Sintaks

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

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 yang berikut ini.

0

Gunakan perilaku default.

WIA_SELECT_DEVICE_NODEFAULT

Tampilkan kotak dialog meskipun hanya ada satu perangkat yang cocok.

pbstrDeviceID [out, retval]

Jenis: BSTR*

Penunjuk ke string yang menerima string pengidentifikasi perangkat.

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::SelectDeviceDlgID meneruskan string pengidentifikasinya ke aplikasi melalui parameter pbstrDeviceID-nya .

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::SelectDeviceDlgID tidak menampilkan kotak dialog Pilih Perangkat . Sebaliknya meneruskan string pengidentifikasi perangkat ke aplikasi tanpa menampilkan kotak dialog. Anda dapat mengambil alih perilaku ini dan memaksa IWiaDevMgr2::SelectDeviceDlgID untuk menampilkan kotak dialog dengan meneruskan 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 SelectDevice sehingga pengguna dapat memilihnya.

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

Bagikan melalui