WIA_DPS_SCAN_AVAILABLE_ITEM
Properti WIA_DPS_SCAN_AVAILABLE_ITEM menyediakan nama sumber input untuk operasi push-scan yang dilakukan aplikasi di bawah kontrol program. Minidriver WIA membuat dan memelihara properti ini.
Jenis Properti: VT_BSTR
Nilai yang Valid: WIA_PROP_NONE
Hak Akses: Baca-saja
Keterangan
Di Windows 7 dan yang lebih baru, WIA_DPS_SCAN_AVAILABLE_ITEM adalah properti opsional dari item akar di pohon item WIA dari perangkat pemindai WIA. Aplikasi dapat meminta properti ini untuk menentukan sumber input (flatbed, pengumpan dokumen otomatis, atau adaptor pemindaian film) untuk dipindai, atau lokasi penyimpanan untuk mentransfer data.
Beberapa perangkat pemindai WIA memungkinkan pengguna untuk memilih sumber input untuk pekerjaan pemindaian dari panel depan perangkat, atau secara implisit memilih sumber input, misalnya, dengan memasukkan dokumen ke dalam pengumpan di perangkat. Ketika pengguna menekan tombol mulai-pindai pada perangkat, aplikasi harus menentukan sumber input mana yang telah dipilih pengguna sehingga dapat memulai operasi pemindaian pada sumber ini.
Peristiwa pemindaian memberi tahu aplikasi bahwa pengguna telah memulai pemindaian, tetapi peristiwa tidak memberikan nama item WIA yang mewakili sumber input. Penanganan aktivitas aplikasi dapat mengkueri properti WIA_DPS_SCAN_AVAILABLE_ITEM item akar untuk mendapatkan nama item sumber input.
Item akar dalam pohon WIA memiliki satu atau beberapa item anak (item flatbed, item pengumpan, dan item film) yang mewakili sumber input pada perangkat. Masing-masing item ini mungkin merupakan item induk ke anak yang mewakili bagian atau wilayah sumber input. Item flatbed yang merupakan anak dari item akar dan yang mewakili flatbed secara keseluruhan dapat memiliki anak-anak (yang juga merupakan item flatbed) yang mewakili wilayah individu dari permukaan flatbed. Item pengumpan yang merupakan anak dari item akar dan yang mewakili pengumpan dokumen otomatis dapat memiliki turunan yang mewakili pemindai untuk sisi depan dan belakang halaman dokumen yang melewati pengumpan. Item film yang merupakan anak dari item akar dan yang mewakili adaptor pemindaian film secara keseluruhan dapat memiliki anak (yang juga merupakan item film) yang mewakili bingkai film individual. Bergantung pada operasi pemindaian yang diminta oleh pengguna, properti WIA_DPS_SCAN_AVAILABLE_ITEM dapat memberi nama item flatbed, feeder, atau film yang merupakan anak dari akar, atau dapat memberi nama anak dari salah satu item ini. Untuk informasi selengkapnya tentang item ini, lihat Kategori Item WIA.
Ketika peristiwa pemindaian terjadi, driver segera mengatur nilai properti WIA_DPS_SCAN_AVAILABLE_ITEM ke nama item WIA (persis seperti yang dilaporkan oleh properti WIA_IPA_ITEM_NAME item) yang mengidentifikasi sumber input tempat pekerjaan pemindaian tersedia, jika informasi ini diketahui. Jika tidak, jika sumber input tidak diketahui, driver mengatur nilai properti ke string kosong. Ketika aplikasi menggunakan peristiwa pemindaian, status peristiwa pemindaian berubah dari yang disinyalkan menjadi tidak diberi sinyal, dan driver mengatur ulang nilai properti WIA_DPS_SCAN_AVAILABLE_ITEM ke string kosong.
Untuk informasi selengkapnya tentang properti ini, lihat Mengidentifikasi Sumber Input untuk Peristiwa Pemindaian.
Persyaratan
Header: wiadef.h (sertakan Wiadef.h)