Perintah Opsional

Perintah berikut dapat diimplementasikan oleh microdriver, tetapi tidak diperlukan untuk melakukannya.

CMD_GETSUPPORTEDFILEFORMATS

Dipanggil oleh Driver Flatbed WIA untuk mendapatkan jumlah format file tambahan. Dua anggota struktur VAL yang diteruskan harus diisi: lVal harus diatur ke jumlah format file tambahan; pGuid harus menunjuk ke array guid format gambar. Memori yang dialokasikan untuk array ini dimiliki oleh microdriver dan hanya boleh dikosongkan olehnya.

Format gambar tercantum dalam wiadef.h atau dapat didefinisikan sebagai format kustom. Perhatikan bahwa karena format BMP (file) dan MEMORYBMP (memori) diperlukan format, WIA Flatbed Driver secara otomatis menambahkannya. Microdriver tidak boleh menambahkannya ke daftar yang diperluas.

Perintah ini bersifat opsional kecuali perangkat dapat mendukung format file tambahan.

CMD_GETSUPPORTEDMEMORYFORMATS

Dipanggil oleh DRIVER Flatbed WIA untuk mendapatkan jumlah format memori tambahan. Dua anggota struktur VAL yang diteruskan harus diisi: lVal harus diatur ke jumlah format memori tambahan; pGuid harus menunjuk ke array guid format gambar. Memori yang dialokasikan untuk array ini dimiliki oleh microdriver dan hanya boleh dikosongkan olehnya.

Format gambar tercantum dalam wiadef.h atau dapat didefinisikan sebagai format kustom. Perhatikan bahwa karena format BMP (file) dan MEMORYBMP (memori) diperlukan format, WIA Flatbed Driver secara otomatis menambahkannya. Microdriver tidak boleh menambahkannya ke daftar yang diperluas.

Perintah ini bersifat opsional kecuali perangkat dapat mendukung format memori tambahan.

CMD_SETFORMAT

Driver kelas mengirimkan perintah ini untuk mengatur format saat ini seperti yang diminta oleh aplikasi. Anggota pGuid dari struktur VAL berisi format gambar GUID. Microdriver harus menyimpan ID format gambar ini dalam konteks privatnya, untuk melacak pengaturan format gambar saat ini.

Microdriver diperlukan untuk mendukung perintah ini hanya jika mereka melaporkan format yang diperluas. Karena driver kelas tidak memiliki cara untuk memvalidasi data dalam format yang diperluas, itu adalah tanggung jawab microdriver untuk menghasilkan data yang tepat. Saat mentransfer data dalam format yang diperluas, semua data harus ditransfer, termasuk header gambar. Misalnya, jika driver Anda melaporkan bahwa driver mendukung format JPEG, maka semua JPEG harus ditransfer, bukan hanya bit gambar.

Driver kelas memiliki memori yang ditujukkan oleh anggota pGuid struktur VAL, sehingga microdriver tidak boleh membebaskannya.

Perhatikan bahwa perintah ini tidak memengaruhi cara microdriver merespons panggilan ke fungsi Pemindaiannya . Seperti biasa, microdriver harus memeriksa nilai parameter lPhase, pScanInfo, dan lLength dari fungsi ini, dan menempatkan data di buffer yang ditunjukkan oleh parameter pBuffer dan pReceived sebagaimana mestinya.

Driver yang hanya mendukung file dalam format WiaImgFmt_BMP dan WiaImgFmt_MEMORYBMP (format default untuk microdriver) dapat menerima perintah CMD_SETFORMAT. Driver ini dapat mengabaikan perintah ini, karena driver kelas menangani semua transfer data menggunakan format default.

CMD_SETSCANMODE

Dipanggil oleh WIA Flatbed Driver untuk mengatur mode pemindaian -- pratinjau atau akhir -- perangkat microdriver. Anggota lVal dari struktur VAL akan berisi salah satu nilai berikut, yang keduanya didefinisikan dalam wiamicro.h:

• SCANMODE_PREVIEWSCAN − Mode pemindaian Pratinjau

• SCANMODE_FINALSCAN − Mode pemindaian akhir

CMD_SETSTIDEVICEHKEY

Dipanggil oleh WIA Flatbed Driver untuk memungkinkan microdriver membaca entri registri di bagian registri yang diinstal. Perintah ini menyediakan HKEY registri yang diinstal perangkat STI ke microdriver, sehingga dapat mengakses nilai registri privat untuk perangkatnya. Anggota pHandle dari struktur VAL akan berisi pointer ke HKEY yang diberikan kepada WIA Flatbed Driver selama metode IStiUSD::Initialize STI. Ini adalah HKEY tingkat atas dari bagian perangkat yang diinstal. Kunci DeviceData dapat dibuka langsung menggunakan HKEY ini. Lihat File INF untuk Perangkat WIA untuk informasi selengkapnya.

Catatan

Kunci ini dibuka dan ditutup hanya oleh Driver Flatbed WIA. Ini juga hanya berlaku selama perintah ini dan CMD_INITIALIZE (lihat Perintah yang Diperlukan). Setelah perintah tersebut kembali, kunci tidak lagi valid. Nilai HKEY tidak boleh di-cache.