Mengidentifikasi Sumber Input untuk Peristiwa Pemindaian

Operasi push-scan adalah operasi pemindaian yang dimulai pengguna dari perangkat pemindai WIA alih-alih dari antarmuka pengguna aplikasi WIA yang berjalan di komputer desktop. Ketika pengguna menekan tombol mulai-pindai pada perangkat, aplikasi menerima peristiwa pemindaian untuk memberi tahu bahwa pengguna telah meminta operasi pemindaian. Menanggapi peristiwa ini, aplikasi dapat melakukan operasi push-scan dengan salah satu dari dua cara berikut:

• Jika perangkat mendukung pemindaian yang dikonfigurasi secara otomatis, aplikasi dapat meminta transfer data dari item otomatis untuk memperoleh gambar dari sumber input yang saat ini dipilih (flatbed, pengumpan dokumen otomatis, atau adaptor pemindaian film). Sebagai respons, perangkat secara otomatis mengonfigurasi pengaturan pemindaiannya (tidak termasuk beberapa properti yang hanya dapat dikonfigurasi oleh aplikasi, yang dijelaskan dalam Properti WIA yang Didukung oleh Item Otomatis) dan kemudian memperoleh gambar.

• Aplikasi dapat melakukan operasi pemindaian di bawah kontrol program langsung. Pertama, aplikasi mengonfigurasi properti item WIA (item flatbed, item pengumpan, atau item film) yang mewakili sumber input yang saat ini dipilih. Selanjutnya, aplikasi memperoleh gambar dengan meminta transfer data dari item ini.

Untuk informasi selengkapnya tentang item WIA, lihat Kategori Item WIA.

Ketika peristiwa pemindaian terjadi, aplikasi menerima pemberitahuan yang menyertakan pengidentifikasi peristiwa WIA (nilai GUID) untuk menentukan sifat peristiwa. Minidriver WIA dapat menetapkan GUID pengidentifikasi peristiwa WIA kustom ke suatu peristiwa, atau minidriver dapat menggunakan salah satu konstanta GUID WIA_EVENT_SCAN_XXXX yang ditentukan dalam file header Wiadef.h. Untuk informasi selengkapnya tentang konstanta ini, lihat Pengidentifikasi Peristiwa WIA.

Meskipun pengidentifikasi peristiwa WIA untuk peristiwa pemindaian memberikan informasi tentang peristiwa tersebut, peristiwa tersebut tidak mengidentifikasi sumber input yang akan digunakan untuk operasi pemindaian. Untuk pemindaian yang dikonfigurasi secara otomatis, aplikasi tidak memerlukan informasi ini. Namun, untuk melakukan pemindaian di bawah kontrol program langsung, aplikasi harus mengetahui sumber input mana yang akan digunakan. Aplikasi harus memiliki cara untuk mendapatkan informasi ini dari perangkat jika perangkat memiliki lebih dari satu sumber input dan pengguna dapat memilih sumber input dari perangkat alih-alih dari antarmuka pengguna aplikasi. Saat memilih sumber input dari perangkat, pengguna dapat memilih sumber secara eksplisit (dengan menekan tombol di panel depan perangkat) atau secara implisit (misalnya, dengan memasukkan dokumen ke dalam pengumpan pada perangkat).

Ketika peristiwa pemindaian terjadi, aplikasi dapat meminta properti WIA_DPS_SCAN_AVAILABLE_ITEM perangkat pemindai WIA untuk mengidentifikasi sumber input yang dipilih, jika perangkat mendukung properti ini. WIA_DPS_SCAN_AVAILABLE_ITEM adalah properti opsional dari item akar di pohon item WIA perangkat. Untuk informasi selengkapnya tentang properti ini, lihat WIA_DPS_SCAN_AVAILABLE_ITEM.

Driver kelas pemindaian WSD mengimplementasikan properti WIA_DPS_SCAN_AVAILABLE_ITEM sebagai fitur driver standar, seperti yang dijelaskan dalam paragraf sebelumnya, alih-alih sebagai ekstensi driver kustom. Untuk informasi selengkapnya tentang driver kelas pemindaian WSD, lihat WIA dengan Layanan Web untuk Perangkat. Untuk informasi selengkapnya tentang WDP untuk pemindai, lihat Layanan Web untuk Skema Layanan Pemindaian Perangkat.