Konstanta Properti Perangkat Pemindai

Artikel
06/13/2023

Perangkat keras Windows Image Acquisition (WIA) memiliki nilai properti yang disimpan di registri Windows. Untuk informasi selengkapnya, lihat Konstanta Properti Perangkat Umum. Konstanta properti perangkat berikut, dengan string terkaitnya, khusus untuk pemindai gambar digital.

Awalan "WIA_DPS_" menunjukkan Properti Perangkat untuk perangkat Pemindai dan merupakan konvensi penamaan yang digunakan dalam C/C++. Untuk tujuan pembuatan skrip, konstanta ini menggunakan awalan "ScannerDevice" dan merupakan bagian dari jenis enumerasi WiaItemPropertyId . Nama anggota yang sesuai dari enumerasi skrip tersebut muncul dalam tanda kurung di samping nama konstanta C/C++ dalam daftar berikut.

Konstanta/nilai Deskripsi

WIA_DPS_DEVICE_ID
ScannerDeviceDeviceId

Catatan:
Properti ini hanya didukung pada Windows Vista dan yang lebih baru.

Berisi pengidentifikasi instans fungsi unik untuk perangkat pemindai layanan web. Pengidentifikasi ini mewakili layanan web pada perangkat pemindai tempat driver mini WIA berkomunikasi. Tidak ada asumsi tentang bentuk pengidentifikasi ini yang harus dibuat. Driver mini WIA membuat dan memelihara properti ini.
Aplikasi WIA dapat menggunakan nilai WIA_DPS_DEVICE_ID untuk menemukan, menggunakan Api Penemuan Fungsi, objek instans fungsi yang mewakili perangkat pemindai layanan web yang digunakan dalam sesi WIA 2.0 saat ini.
Jenis: VT_BSTR, Akses: Baca Saja, Nilai yang valid: WIA_PROP_NONE

WIA_DPS_DITHER_PATTERN_DATA

Dicadangkan, jangan gunakan.
Jenis: VT_I4, Akses: Baca Saja, Nilai yang valid: WIA_PROP_NONE

WIA_DPS_DITHER_SELECT

Dicadangkan, jangan gunakan.
Jenis: VT_I4, Akses: Baca Saja, Nilai yang valid: WIA_PROP_NONE

WIA_DPS_DOCUMENT_HANDLING_CAPABILITIES
ScannerDeviceDocumentHandlingCapabilities

Berisi kemampuan pemindai. Minidriver membuat dan memelihara properti ini.
Aplikasi membaca properti ini untuk menentukan apakah pemindai memiliki flatbed, pengumpan dokumen, atau duplexer yang terinstal. Properti ini juga digunakan untuk menentukan lebih lanjut fitur yang diinstal.
Jenis: VT_I4, Akses: Baca Saja, Nilai yang valid: WIA_PROP_NONE
Tabel berikut ini menjelaskan konstanta yang valid hanya dengan Windows 7.

Bendera	Deskripsi
AUTO_SOURCE	Pemindai memiliki handler dokumen otomatis yang terinstal.

Tabel berikut ini menjelaskan konstanta yang valid hanya dengan Windows 7 dan Windows Vista.

Bendera	Deskripsi
ADVANCED_DUP	Perangkat mendukung konfigurasi pemindaian dupleks tingkat lanjut. Gunakan WIA_IPS_DUPLEX_SETTINGS untuk beralih antara menggunakan konfigurasi dupleks dasar dan tingkat lanjut.
DETECT_FILM_TPA	Pemindai dapat mendeteksi kapan adaptor transparansi/film siap untuk dipindai.
DETECT_STOR	Pemindai dapat mendeteksi kapan ada dokumen di penyimpanan internal.
FILM_TPA	Pemindai dilengkapi dengan adaptor pemindaian transparansi/film.
STOR	Pemindai dilengkapi dengan perangkat penyimpanan gambar internal.

Tabel berikut ini menjelaskan konstanta yang valid dengan Windows XP atau yang lebih baru.

Bendera	Deskripsi
DETECT_FEED	Pemindai dapat mendeteksi dokumen di pengumpan.
DETECT_FLAT	Pemindai dapat mendeteksi dokumen pada platen flatbed.
DETECT_SCAN	Pemindai hanya dapat mendeteksi dokumen di pengumpan dengan memindai.
DUP	Pemindai memiliki duplekser.
FEED	Pemindai memiliki handler dokumen otomatis yang terinstal.
DATAR	Pemindai memiliki platen flatbed.

Tabel berikut ini menjelaskan konstanta yang valid hanya dengan Windows XP. Nilai-nilai ini tidak digunakan lagi untuk Windows 7 dan Windows Vista dan tidak boleh digunakan.

Bendera	Deskripsi
DETECT_DUP	Pemindai dapat mendeteksi permintaan pemindaian dupleks dari pengguna.
DETECT_DUP_AVAIL	Pemindai dapat mengetahui kapan duplexer diinstal.
DETECT_FEED_AVAIL	Pemindai dapat mengetahui kapan pengumpan dokumen otomatis diinstal.

WIA_DPS_DOCUMENT_HANDLING_SELECT
ScannerDeviceDocumentHandlingSelect

Catatan:
Properti ini tidak didukung di Windows Vista dan yang lebih baru. Gunakan WIA_IPS_DOCUMENT_HANDLING_SELECT.

Berisi sumber dan mode akuisisi pemindai saat ini. Minidriver membuat dan memelihara properti ini.

Aplikasi membaca properti ini untuk menentukan sumber akuisisi pemindai saat ini atau menulis properti ini untuk mengatur sumber dan mode pemindai. Selain itu, aplikasi menggunakan properti ini untuk mengaktifkan dan menonaktifkan fungsi duplexer.

Jenis: VT_I4, Akses: Baca/Tulis, Nilai yang valid: WIA_PROP_FLAG

Tabel berikut memiliki sepuluh konstanta yang valid dengan properti ini.

Bendera	Deskripsi
PENGUMPAN	Pindai menggunakan pengumpan dokumen.
FLATBED	Pindai menggunakan flatbed.
DUPLEX	Pindai menggunakan operasi duplexer.
AUTO_ADVANCE	Mengaktifkan pengumpanan otomatis dokumen berikutnya setelah pemindaian.
FRONT_FIRST	Pindai bagian depan dokumen terlebih dahulu. Nilai ini valid ketika DUPLEX diatur.
BACK_FIRST	Pindai bagian belakang dokumen terlebih dahulu. Nilai ini valid ketika DUPLEX diatur.
FRONT_ONLY	Pindai bagian depan saja. Nilai ini valid ketika DUPLEX diatur.
BACK_ONLY	Pindai kembali saja. Nilai ini valid ketika DUPLEX diatur.
NEXT_PAGE	Pindai halaman berikutnya dari dokumen.
PREFEED	Aktifkan mode pra-umpan. Pra-posisi dokumen berikutnya saat memindai.

WIA_DPS_DOCUMENT_HANDLING_STATUS
ScannerDeviceDocumentHandlingStatus

Berisi status pemindai saat ini yang dipasang flatbed, pengumpan dokumen, atau duplexer. Minidriver membuat dan memelihara properti ini.

Aplikasi membaca properti ini untuk menentukan apakah perangkat pemindai siap digunakan. Ini adalah cara yang ideal untuk memeriksa apakah kertas ada di pengumpan sebelum memperoleh gambar.

Jenis: VT_I4, Akses: Baca Saja, Nilai yang valid: WIA_PROP_NONE

Tabel berikut ini memiliki konstanta yang valid dengan properti ini. Tanda bintang * menunjukkan bahwa bendera tidak didukung di Windows Vista atau yang lebih baru. Simbol V menunjukkan bahwa bendera hanya didukung di Windows Vista dan yang lebih baru.

Bendera	Deskripsi
FEED_READY	Flatbed siap digunakan.
FLAT_READY	Pemindai memiliki dokumen pada platen flatbed.
DUP_READY	Duplexer diaktifkan dan siap digunakan.
FLAT_COVER_UP	Penutup tempat tidur datar sudah siap.
PATH_COVER_UP	Jalur kertas ditutupi dan mencegah operasi yang tepat.
PAPER_JAM	Dokumen macet di pengumpan dokumen.
FILM_TPA_READYV	Adaptor transparansi diinstal dan siap digunakan.
STORAGE_READYV	Perangkat penyimpanan internal sudah siap.
STORAGE_FULLV	Penyimpanan penuh, tidak ada operasi unggahan yang dimungkinkan.
MULTIPLE_FEEDV	Terjadi beberapa kondisi umpan (biasanya dengan PAPER_JAM).
DEVICE_ATTENTIONV	Ada kesalahan yang memerlukan intervensi pengguna pada perangkat.
LAMP_ERRV	Pemindai belum siap karena masalah lampu.

WIA_DPS_ENDORSER_CHARACTERS
ScannerDeviceEndorserCharacters

Berisi semua karakter valid yang dapat digunakan aplikasi untuk membuat string endorser yang valid. Endorser adalah printer yang diinstal pada pemindai yang mencetak pesan teks pada setiap halaman yang dipindai. Minidriver harus memvalidasi pengaturan properti WIA_DPS_ENDORSER_STRING terhadap set karakter yang valid dalam properti ini. Minidriver membuat dan memelihara properti ini.

Jenis: VT_BSTR, Akses: Baca Saja, Nilai yang valid: WIA_PROP_NONE

WIA_DPS_ENDORSER_STRING
ScannerDeviceEndorserString

Berisi string yang akan didukung (dengan kata lain, dicetak) pada setiap halaman yang dipindai oleh minidriver. Aplikasi mengatur properti ini menggunakan kumpulan karakter valid yang dilaporkan dalam properti WIA_DPS_ENDORSER_CHARACTERS . Minidriver harus mendukung dokumen hanya jika string diatur dalam properti ini. String kosong berarti fungsionalitas endorser dinonaktifkan.

Karena merupakan tanggung jawab pengemudi untuk menafsirkan string endorser, driver Anda dapat menggunakan karakter khusus dalam WIA_DPS_ENDORSER_STRING. Namun, hanya aplikasi Anda yang akan memahami karakter ini.

Jenis: VT_BSTR, Akses: Baca/Tulis, Nilai yang valid: WIA_PROP_NONE

Driver yang mendukung properti WIA_DPS_ENDORSER_STRING harus mendukung daftar token berikut.

Token	Deskripsi
$DATE$	Tanggal dalam formulir YYYY/MM/DD.
$DAY$	Hari dalam bentuk DD.
$MONTH$	Bulan dalam setahun dalam bentuk MM.
$PAGE_COUNT$	Jumlah halaman yang ditransfer.
$TIME$	Waktu dalam bentuk HH:MM:SS.
$YEAR$	Tahun dalam bentuk YYYY.

WIA_DPS_FILTER_SELECT

Dicadangkan, jangan gunakan.

Jenis: VT_I4, Akses: Baca Saja, Nilai yang valid: WIA_PROP_NONE

WIA_DPS_GLOBAL_IDENTITY
ScannerDeviceglobalIdentity

Catatan:
Properti ini hanya didukung pada Windows Vista dan yang lebih baru.

Berisi alamat SOAP perangkat pemindai layanan web. Driver mini WIA 2.0 membuat dan memelihara properti ini.

Jenis: VT_BSTR, Akses: Baca Saja, Nilai yang valid: WIA_PROP_NONE

WIA_DPS_HORIZONTAL_BED_REGISTRATION
ScannerDeviceHorizontalBedRegistration

Catatan:
Properti ini tidak didukung dengan Windows Vista dan yang lebih baru.

Berisi pendaftaran, atau perataan horizontal, untuk dokumen yang ditempatkan di flatbed. Minidriver membuat dan memelihara properti ini.

Jenis: VT_I4, Akses: Baca Saja, Nilai yang valid: WIA_PROP_NONE

Tabel berikut ini memiliki tiga konstanta yang valid dengan properti ini.

Terus-menerus	Deskripsi
LEFT_JUSTIFIED	Kertas dibiarkan dibenarkan.
BERPUSAT	Kertas dipusatkan.
RIGHT_JUSTIFIED	Makalahnya tepat dibenarkan.

Lihat Juga

WIA_DPS_VERTICAL_BED_REGISTRATION

WIA_DPS_HORIZONTAL_BED_SIZE
ScannerDeviceHorizontalBedSize

Catatan:
Properti ini tidak didukung dengan Windows Vista dan yang lebih baru. Gunakan WIA_IPS_MAX_HORIZONTAL_SIZE.

Menentukan lebar maksimum, dalam seribu inci, yang dipindai dalam sumbu horizontal (X) dari pelat pemindai flatbed pada resolusi saat ini. Properti ini juga berlaku untuk pengumpan dokumen otomatis yang memindahkan lembar ke platen pemindai flatbed untuk pemindaian. Properti ini wajib untuk pemindai yang memiliki platen. Jenis pemindai lainnya akan mengimplementasikan properti WIA_DPS_HORIZONTAL_SHEET_FEED_SIZE .

Jenis: VT_I4, Access: Baca Saja, Nilai yang valid: WIA_PROP_NONE

WIA_DPS_HORIZONTAL_SHEET_FEED_SIZE
ScannerDeviceHorizontalSheetFeedSize

Catatan:
Properti ini tidak didukung dengan Windows Vista dan yang lebih baru. Gunakan WIA_IPS_MAX_HORIZONTAL_SIZE.

Menentukan lebar maksimum, dalam seribu inci, yang dipindai dalam sumbu horizontal (X) dari pemindai umpan genggam atau lembar pada resolusi saat ini. Properti ini juga berlaku untuk pengumpan dokumen otomatis yang memindai tanpa memindahkan lembar ke platen pemindai flatbed. Properti ini wajib untuk pemindai sheet-fed, scroll-fed, dan hand-held.

Jenis: VT_I4, Access: Baca Saja, Nilai yang valid: WIA_PROP_NONE

WIA_DPS_MAX_SCAN_TIME
ScannerDeviceMaxScanTime

Berisi waktu maksimum untuk memindai satu halaman dengan pengaturan properti saat ini, dalam milidetik. Aplikasi membaca properti ini untuk memperkirakan waktu yang diperlukan untuk memindai halaman. Ini berguna saat menentukan kondisi perangkat yang berhenti merespons. Minidriver membuat dan memelihara properti ini. Properti ini diperlukan untuk semua pemindai.

Jenis: VT_I4, Access: Baca Saja, Nilai yang valid: WIA_PROP_NONE

WIA_DPS_MIN_HORIZONTAL_SHEET_FEED_SIZE
ScannerDeviceMinHorizontalSheetFeedSize

Catatan:
Properti ini tidak didukung dengan Windows Vista dan yang lebih baru. Gunakan WIA_IPS_MIN_HORIZONTAL_SIZE.

Berisi dimensi horizontal fisik dari halaman terkecil yang dapat dipindai oleh pengumpan dokumen pemindai, dalam seribu inci. Minidriver membuat dan memelihara properti ini.

Jenis: VT_I4, Access: Baca Saja, Nilai yang valid: WIA_PROP_NONE

Lihat Juga

WIA_DPS_MIN_VERTICAL_SHEET_FEED_SIZE

WIA_DPS_MIN_VERTICAL_SHEET_FEED_SIZE
ScannerDeviceMinVerticalSheetFeedSize

Catatan:
Properti ini tidak didukung dengan Windows Vista dan yang lebih baru. Gunakan WIA_IPS_MIN_VERTICAL_SIZE.

Berisi dimensi vertikal fisik dari halaman terkecil yang dapat dipindai oleh pengumpan dokumen pemindai, dalam seribu inci. Minidriver membuat dan memelihara properti ini.

Jenis: VT_I4, Access: Baca Saja, Nilai yang valid: WIA_PROP_NONE

Lihat Juga

WIA_DPS_MIN_HORIZONTAL_SHEET_FEED_SIZE

WIA_DPS_OPTICAL_XRES
ScannerDeviceOpticalXres

Catatan:
Properti ini tidak didukung oleh Windows Vista. Gunakan WIA_IPS_OPTICAL_XRES.

Resolusi Optik Horizontal. Resolusi optik horizontal tertinggi yang didukung di DPI. Properti ini adalah nilai tunggal. Ini bukan daftar semua resolusi yang dapat dihasilkan oleh perangkat. Sebaliknya, ini adalah resolusi optik perangkat. Minidriver membuat dan memelihara properti ini. Properti ini diperlukan untuk semua pemindai.

Jenis: VT_I4, Access: Baca Saja, Nilai yang valid: WIA_PROP_NONE

WIA_DPS_OPTICAL_YRES
ScannerDeviceOpticalYres

Catatan:
Properti ini tidak didukung oleh Windows Vista. Gunakan WIA_IPS_OPTICAL_YRES.

Resolusi Optik Vertikal. Resolusi optik vertikal tertinggi yang didukung di DPI. Properti ini adalah nilai tunggal. Ini bukan daftar semua resolusi yang dihasilkan oleh perangkat. Sebaliknya, ini adalah resolusi optik perangkat. Minidriver membuat dan memelihara properti ini. Properti ini diperlukan untuk semua pemindai.

Jenis: VT_I4, Access: Baca Saja, Nilai yang valid: WIA_PROP_NONE

WIA_DPS_ORIENTATION
ScannerDeviceOrientation

Berisi pengaturan orientasi saat ini. Minidriver membuat dan memelihara properti ini.

Aplikasi mengatur properti WIA_DPS_ORIENTATION untuk menentukan orientasi asli halaman atau gambar yang akan diperoleh. Untuk informasi tentang cara menggunakan WIA_DPS_ORIENTATION, lihat WIA_DPS_PAGE_SIZE

Jenis: VT_I4, Access: Baca/Tulis, Nilai yang valid: WIA_PROP_LIST

Tabel berikut ini memiliki empat konstanta yang valid dengan properti ini.

Nilai	Definasi
LANSKAP	Rotasi berlawanan arah jaring jam 90 derajat, relatif terhadap orientasi POTRET.
POTRET	0 derajat.
ROT180	Rotasi berlawanan arah jaring jam 180 derajat, relatif terhadap orientasi PORTRAIT.
ROT270	Rotasi berlawanan arah jaring jam 270 derajat, relatif terhadap orientasi PORTRAIT.

Lihat Juga

WIA_IPS_ROTATION

WIA_DPS_PAD_COLOR
ScannerDevicePadColor

Warna yang digunakan untuk pad ketika tidak ada cukup data gambar untuk mengisi buffer yang diminta. Properti ini diimplementasikan untuk pemindai yang menyatukan buffer. Properti ini bersifat opsional untuk semua pemindai. Minidriver membuat dan memelihara properti ini.

Jenis: VT_UI1 | VT_VECTOR, Access: Baca Saja, Nilai yang valid: WIA_PROP_NONE

Format informasi warna adalah RGBQUAD.

WIA_DPS_PAGE_HEIGHT
ScannerDevicePageHeight

Catatan:
Properti ini tidak didukung oleh Windows Vista. Gunakan WIA_IPS_PAGE_HEIGHT.

Berisi tinggi, dalam seribu inci, dari halaman yang saat ini dipilih. Minidriver membuat dan memelihara properti WIA_DPS_PAGE_HEIGHT . Aplikasi membaca properti ini untuk menentukan dimensi fisik halaman yang sedang dipindai. Jika pengaturan jangkauan berbeda dari ukuran halaman yang diketahui, properti ini melaporkan tinggi halaman yang properti WIA_DPS_PAGE_SIZE-nya diatur ke WIA_PAGE_CUSTOM (yang merupakan nilai properti WIA_DPS_PAGE_SIZE ). WIA_DPS_PAGE_HEIGHT harus sinkron dengan WIA_IPS_XEXTENT, yang melaporkan tinggi, dalam piksel, halaman yang akan dipindai.

Jenis: VT_I4, Access: Baca Saja, Nilai yang valid: WIA_PROP_NONE

WIA_DPS_PAGE_SIZE
ScannerDevicePageSize

Catatan:
Properti ini tidak didukung oleh Windows Vista. Gunakan WIA_IPS_PAGE_SIZE.

Berisi ukuran halaman yang saat ini dipilih untuk dipindai. Untuk memilih dimensi halaman yang akan dipindai, aplikasi mengatur properti ini. Minidriver membuat dan memelihara properti ini.

Jenis: VT_I4, Access: Baca/Tulis, Nilai yang valid: WIA_PROP_LIST

Tabel berikut ini memiliki tiga konstanta yang valid dengan properti ini.

Nilai	Definisi
WIA_PAGE_A4	8267 X 11692 (Orientasi POTRET)
WIA_PAGE_CUSTOM	Ditentukan oleh nilai properti WIA_DPS_PAGE_HEIGHT dan WIA_DPS_PAGE_WIDTH
WIA_PAGE_LETTER	8500 X 11000 (Orientasi POTRET)

Nilai properti WIA_IPS_ORIENTATION menentukan orientasi halaman yang saat ini dipilih. Properti WIA_DPS_PAGE_WIDTH dan WIA_DPS_PAGE_HEIGHT melaporkan dimensi halaman, dalam seribu inci. Perhatikan bahwa properti ini harus sesuai dengan WIA_IPS_XEXTENT dan WIA_IPS_YEXTENT, yang berisi dimensi halaman dalam piksel. Nilai tipe WIA_PROP_LIST yang valid harus bergantung pada pengaturan properti WIA_IPS_ORIENTATION yang valid. Jika perangkat tidak dapat memindai dokumen berorientasi lanskap dengan pengaturan WIA_PAGE_A4, WIA_PAGE_A4 tidak boleh muncul dalam daftar nilai yang valid untuk properti WIA_DPS_PAGE_SIZE saat WIA_IPS_ORIENTATION diatur ke LANSCAPE.

Jika aplikasi menetapkan WIA_DPS_PAGE_SIZE ke nilai apa pun selain WIA_PAGE_CUSTOM, minidriver harus menyesuaikan nilai WIA_DPS_PAGE_WIDTH dan WIA_DPS_PAGE_HEIGHT ke dimensi halaman dalam seperseribu inci. Ini juga harus menyesuaikan nilai WIA_IPS_XEXTENT dan WIA_IPS_YEXTENT ke dimensi halaman dalam piksel.

Jika pengaturan jangkauan (WIA_IPS_XEXTENT atau WIA_IPS_YEXTENT) diubah menjadi nilai yang tidak cocok dengan pengaturan ukuran halaman saat ini, minidriver harus mengubah nilai properti WIA_DPS_PAGE_SIZE menjadi WIA_PAGE_CUSTOM. Minidriver juga harus memodifikasi WIA_DPS_PAGE_WIDTH atau WIA_DPS_PAGE_HEIGHT sesuai dengan pengaturan jangkauan baru.

Jika WIA_IPS_ORIENTATION diatur ke LANSCAPE, pengaturan jangkauannya akan "dibalik." Misalnya, jika aplikasi mengatur WIA_DPS_PAGE_SIZE ke WIA_PAGE_A4, minidriver harus mengatur WIA_DPS_PAGE_WIDTH ke 11692 dan WIA_DPS_PAGE_HEIGHT ke 8267. (Minidriver juga harus mengatur WIA_IPS_XEXTENT dan WIA_IPS_YEXTENT yang sesuai.) Perhatikan bahwa jika WIA_DPS_PAGE_SIZE diatur ke WIA_PAGE_CUSTOM, pengaturan orientasi tidak digunakan untuk menentukan dimensi jangkauan halaman yang akan dipindai.

Minidriver bertanggung jawab untuk memastikan bahwa properti WIA_IPS_ORIENTATION sesuai dengan area pilihan saat ini. Jika aplikasi mengubah nilai WIA_IPS_ORIENTATION menjadi yang tidak valid untuk ukuran halaman yang saat ini dipilih, minidriver harus mengubah nilai WIA_DPS_PAGE_SIZE menjadi ukuran halaman yang didukung oleh nilai orientasi baru.

Jika aplikasi mengatur properti WIA_DPS_PAGE_SIZE ke WIA_PAGE_CUSTOM, area pilihan saat ini tidak terpengaruh. Minidriver WIA harus mendapatkan tata letak gambar saat ini, mulai dari pengaturan properti WIA_IPS_XPOS dan WIA_IPS_YPOS saat ini. Jika pengaturan ukuran halaman menghasilkan area pilihan yang berada di luar tempat tidur pemindai, minidriver harus secara otomatis menyesuaikan nilai properti WIA_IPS_XPOS dan WIA_IPS_YPOS ke pengaturan yang valid. Jika properti WIA_DPS_PAGE_SIZE dan WIA_IPS_ORIENTATION diatur pada saat yang sama, dan tidak valid saat diterapkan dalam kombinasi, minidriver harus gagal dalam pengaturan aplikasi dengan mengembalikan kesalahan di IWiaMiniDrv::d rvValidateItemProperties. .

Empat contoh berikut menunjukkan skenario WIA_DPS_PAGE_SIZE yang berbeda.

Driver melaporkan pengaturan.
Aplikasi mengatur properti WIA_DPS_PAGE_SIZE ke WIA_PAGE_LETTER.
Aplikasi mengatur properti WIA_IPS_ORIENTATION ke LANSCAPE.
Aplikasi mengubah properti WIA_IPS_XEXTENT menjadi nilai yang lebih kecil.

Contoh 1: Minidriver melaporkan pengaturan

Dalam contoh berikut, minidriver mengatur area pilihan kustom sebelum aplikasi mengatur properti WIA apa pun. Dalam hal ini, area pilihan mewakili seluruh flatbed.

WIA_DPS_PAGE_SIZE = WIA_PAGE_CUSTOM
WIA_DPS_PAGE_WIDTH = 11500
WIA_DPS_PAGE_HEIGHT = 14000
WIA_IPS_ORIENTATION = PORTRAIT
WIA_IPS_XPOS = 0
WIA_IPS_YPOS = 0
WIA_IPS_XEXTENT = 1150
WIA_IPS_YEXTENT = 1400
WIA_IPS_XRES = 100
WIA_IPS_YRES = 100

Contoh 2: Aplikasi mengatur properti WIA_DPS_PAGE_SIZEke WIA_PAGE_LETTER

WIA_DPS_PAGE_SIZE = WIA_PAGE_LETTER
WIA_DPS_PAGE_WIDTH = 8500
WIA_DPS_PAGE_HEIGHT = 11000
WIA_IPS_ORIENTATION = PORTRAIT
WIA_IPS_XPOS = 0
WIA_IPS_YPOS = 0
WIA_IPS_XEXTENT = 850
WIA_IPS_YEXTENT = 1100
WIA_IPS_XRES = 100
WIA_IPS_YRES = 100

Contoh 3: Aplikasi mengatur properti WIA_IPS_ORIENTATIONke LANSCAPE

Tempat tidur fisik harus dapat memperoleh halaman yang awalnya dalam orientasi lanskap.

WIA_DPS_PAGE_SIZE = WIA_PAGE_LETTER
WIA_DPS_PAGE_HEIGHT = 11000
WIA_DPS_PAGE_WIDTH = 8500
WIA_IPS_ORIENTATION = LANSCAPE
WIA_IPS_XPOS = 0
WIA_IPS_YPOS = 0
WIA_IPS_XEXTENT = 1100
WIA_IPS_YEXTENT = 850
WIA_IPS_XRES = 100
WIA_IPS_YRES = 100

Contoh 4: Aplikasi mengubah properti WIA_IPS_XEXTENTmenjadi nilai yang lebih kecil

Dalam contoh berikut, aplikasi mengubah properti WIA_IPS_XEXTENT menjadi 1000. Minidriver harus mengasumsikan bahwa nilai baru yang terkandung dalam WIA_IPS_XEXTENT tidak lagi valid untuk properti WIA_DPS_PAGE_SIZE dan dengan demikian harus mengubah WIA_DPS_PAGE_SIZE menjadi WIA_PAGE_CUSTOM. Minidriver juga harus menyesuaikan WIA_DPS_PAGE_WIDTH.

WIA_DPS_PAGE_SIZE = WIA_PAGE_CUSTOM
WIA_DPS_PAGE_HEIGHT = 10000
WIA_DPS_PAGE_WIDTH = 8500
WIA_IPS_ORIENTATION = LANSCAPE
WIA_IPS_XPOS = 0
WIA_IPS_YPOS = 0
WIA_IPS_XEXTENT = 1000
WIA_IPS_YEXTENT = 850
WIA_IPS_XRES = 100
WIA_IPS_YRES = 100

WIA_DPS_PAGE_WIDTH
ScannerDevicePageWidth

Catatan:
Properti ini tidak didukung oleh Windows Vista. Gunakan WIA_IPS_PAGE_WIDTH.

Berisi lebar halaman saat ini yang dipilih, dalam seribu inci. Aplikasi membaca properti ini untuk menentukan dimensi fisik halaman yang sedang dipindai. Jika pengaturan jangkauan berbeda dari ukuran halaman yang diketahui, properti ini melaporkan lebar halaman yang properti WIA_DPS_PAGE_SIZE-nya diatur ke WIA_PAGE_CUSTOM. WIA_DPS_PAGE_WIDTH harus sinkron dengan nilai WIA_IPS_XEXTENT, yang melaporkan lebar, dalam piksel, halaman yang akan dipindai. Minidriver membuat dan memelihara properti ini.

Jenis: VT_I4, Access: Baca Saja, Nilai yang valid: WIA_PROP_NONE

WIA_DPS_PAGES
ScannerDevicePages

Catatan:
Properti ini tidak didukung oleh Windows Vista. Gunakan WIA_IPS_PAGES.

Berisi jumlah halaman saat ini yang akan diperoleh dari pengumpan dokumen otomatis. Minidriver membuat dan memelihara properti ini.

Jenis: VT_I4; Akses: Baca/Tulis; Nilai yang valid: WIA_PROP_RANGE (nol hingga jumlah maksimum halaman yang dapat ditahan pengumpan dokumen)

Aplikasi membaca properti ini untuk menentukan kapasitas halaman pengumpan dokumen. Aplikasi ini juga mengatur properti ini ke jumlah halaman yang akan dipindai.

Catatan:
Jika mode dupleks diaktifkan (WIA_DPS_DOCUMENT_HANDLING_SELECT diatur ke FEEDER | DUPLEX ), WIA_DPS_PAGES masih sama dengan jumlah halaman yang akan dipindai.

Satu lembar kertas akan secara otomatis berisi dua halaman jika DUPLEX diaktifkan, meskipun sisi belakang halaman kosong.

Mengatur WIA_DPS_PAGES ke 1 menyebabkan pemindai memproses salah satu sisi halaman. Disarankan agar jika pemindai tidak dapat memindai hanya satu sisi halaman saat dalam mode dupleks, nilai WIA_DPS_PAGES valid untuk anggota Inc dari struktur WIA_PROPERTY_INFO harus diubah menjadi 2. Nilai ini menandakan aplikasi bahwa aplikasi harus meminta halaman dalam kelipatan dua. Nilai nol berarti bahwa semua halaman yang saat ini dimuat ke dalam pengumpan dokumen akan dipindai.

WIA_DPS_PLATEN_COLOR
ScannerDevicePlatenColor

Menentukan warna platen di belakang lembar yang akan dipindai. Properti ini bersifat opsional untuk pemindai yang memiliki platen. Minidriver membuat dan memelihara properti ini.

Jenis: VT_VECTOR VT_UI1 | , Akses: Baca Saja, Nilai yang valid: WIA_PROP_NONE

Format informasi warna adalah RGBQUAD.

WIA_DPS_PREVIEW
ScannerDevicePreview

Catatan:
Properti ini tidak didukung oleh Windows Vista. Gunakan WIA_IPS_PREVIEW.

Menunjukkan mode pratinjau untuk perangkat. Aplikasi mengatur properti ini untuk menempatkan perangkat ke dalam mode pratinjau.

Jenis: VT_I4, Akses: Baca/Tulis, Nilai yang valid: WIA_PROP_LIST

Tabel berikut ini memiliki dua konstanta yang valid dengan properti ini.

Nilai	Definisi
WIA_FINAL_SCAN	Aplikasi akan melakukan pemindaian akhir.
WIA_PREVIEW_SCAN	Aplikasi akan melakukan pemindaian pratinjau.

WIA_DPS_SCAN_AHEAD_PAGES
ScannerDeviceScanAheadPages

Berisi nilai yang menunjukkan apakah pemindai akan menyimpan halaman dalam buffer pemindai sebelum mengirimkannya ke aplikasi.

Nilai nol menonaktifkan pemindaian di depan dan tidak ada halaman yang akan dipindai di depan. Melakukan transfer data normal pada item scan-ahead yang di-buffer mengambil halaman yang di-buffer. Properti WIA tidak dapat diubah selama operasi scan-ahead. Properti ini bersifat opsional.

Jenis: VT_I4, Access: Read/Write, Nilai valid: WIA_PROP_RANGE nol hingga jumlah maksimum halaman yang dapat ditahan oleh pengumpan dokumen.

WIA_DPS_SCAN_AVAILABLE_ITEM
ScannerDeviceScanAvailableItem

Catatan:
Properti ini hanya didukung oleh Windows 7 dan yang lebih baru.

Menunjukkan sumber input (flatbed, pengumpan dokumen otomatis, atau adaptor pemindaian fil) untuk dipindai, atau lokasi penyimpanan untuk mentransfer data.

Peristiwa pemindaian memberi tahu aplikasi bahwa pengguna telah memulai pemindaian, tetapi peristiwa tidak menyediakan 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.

Jenis: VT_I4, Access: Read/Write, Nilai valid: WIA_PROP_RANGE nol hingga jumlah maksimum halaman yang dapat ditahan oleh pengumpan dokumen.

WIA_DPS_SERVICE_ID
ScannerDeviceServiceId

Catatan:
Properti ini hanya didukung oleh Windows Vista dan yang lebih baru.

Berisi ID Layanan perangkat pemindai Layanan Web. Driver mini WIA 2.0 membuat dan memelihara properti ini.

Jenis: VT_BSTR, Akses: Baca Saja, Nilai yang valid: WIA_PROP_NONE

WIA_DPS_SHEET_FEEDER_REGISTRATION
ScannerDeviceSheetFeederRegistration

Catatan:
Properti ini tidak didukung dengan Windows Vista dan yang lebih baru. Gunakan WIA_IPS_SHEET_FEEDER_REGISTRATION.

Berisi pendaftaran, atau perataan dan deteksi tepi, untuk dokumen yang ditempatkan di flatbed. Minidriver membuat dan memelihara properti ini. Properti ini menunjukkan bagaimana lembar diposisikan secara horizontal pada kepala pemindaian pemindaian handheld atau sheet-fed. Properti digunakan untuk memprediksi di mana seluruh kepala pemindaian dokumen ditempatkan.

Untuk pemindai yang mendukung lebih dari satu kepala pemindaian, properti ini relatif terhadap kepala pemindaian paling atas. Properti ini wajib untuk pemindai sheet-fed, scroll-fed, dan handheld.

Jenis: VT_I4, Akses: Baca Saja, Nilai yang valid: WIA_PROP_NONE

Tabel berikut ini memiliki tiga konstanta yang valid dengan properti ini.

Terus-menerus	Deskripsi
LEFT_JUSTIFIED	Lembar diposisikan ke kiri sehubungan dengan kepala pemindaian.
BERPUSAT	Lembaran berpusat pada kepala pemindaian.
RIGHT_JUSTIFIED	Lembar diposisikan ke kanan sehubungan dengan kepala pemindaian.

WIA_DPS_SHOW_PREVIEW_CONTROL
ScannerDeviceShowPreviewControl

Catatan:
Properti ini tidak didukung oleh Windows Vista. Gunakan WIA_IPS_SHOW_PREVIEW_CONTROL.

Menunjukkan apakah item memerlukan kontrol pratinjau yang ditampilkan kepada pengguna. Minidriver membuat dan memelihara properti ini.

Jenis: VT_I4, Akses: Baca Saja, Nilai yang valid: WIA_PROP_NONE

Tabel berikut ini memiliki dua konstanta yang valid dengan properti ini.

Terus-menerus	Deskripsi
WIA_SHOW_PREVIEW_CONTROL	Perlihatkan kontrol pratinjau kepada pengguna, karena perangkat ini bisa melakukan pratinjau.
WIA_DONT_SHOW_PREVIEW_CONTROL	Jangan tampilkan kontrol pratinjau kepada pengguna, karena perangkat ini tidak dapat melakukan pratinjau.

WIA_DPS_USER_NAME
ScannerDeviceUserName

Catatan:
Properti ini hanya didukung oleh Windows Vista dan yang lebih baru.

Digunakan oleh layanan WIA untuk memberi tahu driver mini tentang nama akun pengguna (termasuk nama domain jaringan jika berlaku) dari sesi tempat aplikasi WIA saat ini berjalan.

Ini adalah properti item akar, dikelola oleh layanan WIA.

Jenis: VT_BSTR, Akses: Baca Saja, Nilai yang valid: WIA_PROP_NONE

WIA_DPS_VERTICAL_BED_REGISTRATION
ScannerDeviceVerticalBedRegistration

Catatan:
Properti ini tidak didukung dengan Windows Vista dan yang lebih baru.

Berisi pendaftaran, atau perataan vertikal dan deteksi tepi, untuk dokumen yang ditempatkan di flatbed. Minidriver membuat dan memelihara properti ini.

Jenis: VT_I4, Akses: Baca Saja, Nilai yang valid: WIA_PROP_NONE

Tabel berikut ini memiliki tiga konstanta yang valid dengan properti ini..

Terus-menerus	Deskripsi
TOP_JUSTIFIED	Kertasnya dibenarkan.
BERPUSAT	Kertas berpusat.
BOTTOM_JUSTIFIED	Koran dibenarkan bawah.

Lihat juga.

WIA_DPS_HORIZONTAL_BED_REGISTRATION

WIA_DPS_VERTICAL_BED_SIZE
ScannerDeviceVerticalBedSize

Catatan:
Properti ini tidak didukung dengan Windows Vista dan yang lebih baru. Gunakan WIA_IPS_MAX_VERTICAL_SIZE.

Menentukan tinggi maksimum, dalam seribu inci, yang dipindai dalam sumbu vertikal (Y) dari pelat pemindai flatbed pada resolusi saat ini. Properti ini juga berlaku untuk pengumpan dokumen otomatis, yang memindahkan lembar ke platen pemindai flatbed untuk pemindaian. Properti ini wajib untuk pemindai yang memiliki platen. Jenis pemindai lainnya akan mengimplementasikan properti WIA_DPS_VERTICAL_SHEET_FEED_SIZE .

Jenis: VT_I4, Access: Baca Saja, Nilai yang valid: WIA_PROP_NONE

WIA_DPS_VERTICAL_SHEET_FEED_SIZE
ScannerDeviceVerticalSheetFeedSize

Catatan:
Properti ini tidak didukung dengan Windows Vista dan yang lebih baru. Gunakan WIA_IPS_MAX_VERTICAL_SIZE.

Menentukan tinggi maksimum, dalam seribu inci, yang dipindai dalam sumbu vertikal (Y) dari pemindai umpan genggam atau lembar pada resolusi saat ini. Properti ini juga berlaku untuk pengumpan dokumen otomatis yang memindai tanpa memindahkan lembar ke platen pemindai flatbed. Properti ini wajib untuk pemindai sheet-fed. Pemindai scroll-fed dan hand-held tidak boleh mengimplementasikan properti ini.

Jenis: VT_I4, Access: Baca Saja, Nilai yang valid: WIA_PROP_NONE

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows 2000 Professional, Windows XP [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2003 [hanya aplikasi desktop]
Header	Wiadef.h

Bagikan melalui

Konstanta Properti Perangkat Pemindai

Persyaratan

Saran dan Komentar

Sumber Daya Tambahan: