Pustaka layanan driver WIA
Pustaka layanan driver WIA berisi fungsi yang dapat dipanggil oleh minidriver WIA untuk mendapatkan bantuan dalam melakukan tugas-tugas berikut:
Minidriver WIA memanggil sebagian besar fungsi ini dari metode Antarmuka IWiaMiniDrv sesuai kebutuhan. Namun, setiap minidriver WIA harus memanggil fungsi wiasCreateDrvItem di metode IWiaMiniDrv::d rvInitializeWia untuk membuat item driver. Setiap panggilan yang berhasil ke fungsi wiasCreateDrvItem membuat objek item IWiaDrvItem , yang digunakan di pohon item minidriver. Beberapa metode Antarmuka IWiaDrvItem memiliki parameter jenis IWiaDrvItem, termasuk IWiaDrvItem::AddItemToFolder, IWiaDrvItem::GetFirstChildItem, IWiaDrvItem::GetNextSiblingItem, dan IWiaDrvItem::GetParentItem. Selain itu, fungsi wiasGetDrvItem memiliki parameter jenis ini.
Pustaka layanan driver menyediakan fungsi berikut.
Membangun dan memelihara pohon item
| Fungsi | Deskripsi |
|---|---|
| wiasCreateChildAppItem | Membuat item aplikasi baru dan menyisipkannya sebagai anak dari item (induk) yang ditentukan. |
| wiasCreateDrvItem | Membuat objek IWiaDrvItem . |
| wiasGetChildrenContexts | Mengambil array konteks item milik turunan item saat ini. |
| wiasGetContextFromName | Mengambil konteks item untuk nama item. |
| wiasGetDrvItem | Mengambil item driver. |
| wiasGetRootItem | Mengambil konteks item akar dari item WIA tertentu. |
Mencatat kesalahan dan melacak pesan
| Fungsi | Deskripsi |
|---|---|
| wiasCreateLogInstance | Membuat instans objek pengelogan. |
| wiasDebugError | Mencetak string kesalahan debug di konsol debug Device Manager. Warna output selalu merah. Fungsi ini disediakan hanya untuk kompatibilitas. Disarankan untuk menggunakan WIAS_ERROR sebagai gantinya. |
| wiasDebugTrace | Mencetak string jejak debug di konsol debug Device Manager. Fungsi ini disediakan hanya untuk kompatibilitas. Disarankan untuk menggunakan WIA_TRACE sebagai gantinya. |
| wiasFormatArgs | Memformat daftar argumen ke dalam string paket untuk pengelogan. |
| wiasPrintDebugHResult | Mencetak string HRESULT di konsol debug Device Manager. Fungsi ini disediakan hanya untuk kompatibilitas. Ini usang dan tidak lagi didukung. Gunakan WIAS_LHRESULT sebagai gantinya. |
Membaca dan menyimpan properti item
| Fungsi | Deskripsi |
|---|---|
| wiasCreatePropContext | Mengalokasikan konteks properti untuk menunjukkan properti item mana yang berubah. |
| wiasFreePropContext | Melepaskan memori yang ditempati oleh struktur WIA_PROPERTY_CONTEXT . |
| wiasGetChangedValueFloat | Menentukan apakah properti dengan nilai floating-point telah diubah oleh aplikasi. |
| wiasGetChangedValueGuid | Menentukan apakah properti dengan nilai GUID telah diubah oleh aplikasi. |
| wiasGetChangedValueLong | Menentukan apakah properti dengan nilai bilangan bulat panjang telah diubah oleh aplikasi. |
| wiasGetChangedValueStr | Menentukan apakah properti dengan nilai string telah diubah oleh aplikasi. |
| wiasGetItemType | Menunjukkan item akar atau turunan. |
| wiasGetPropertyAttributes | Mengambil bendera akses dan nilai yang valid untuk sekumpulan properti. |
| wiasIsPropChanged | Menguji apakah properti yang ditentukan telah diubah oleh aplikasi. |
| wiasReadMultiple | Membaca beberapa properti dari item WIA. |
| wiasReadPropBin | Membaca satu properti biner dari item WIA. |
| wiasReadPropFloat | Mengambil nilai properti floating-point dari item WIA. |
| wiasReadPropGuid | Mengambil nilai properti GUID dari item WIA. |
| wiasReadPropLong | Mengambil nilai properti bilangan bulat panjang dari item WIA. |
| wiasReadPropStr | Mengambil nilai properti string dari item WIA. |
| wiasSetItemPropAttribs | Mengatur bendera akses dan nilai yang valid untuk sekumpulan properti item. |
| wiasSetItemPropNames | Menulis nama properti ke properti item. |
| wiasSetPropChanged | Memodifikasi konteks properti untuk menunjukkan bahwa properti sedang diubah. |
| wiasSetPropertyAttributes | Mengatur bendera akses dan nilai properti properti item. |
| wiasSetValidFlag | Mengatur nilai yang valid untuk properti WIA_PROP_FLAG. |
| wiasSetValidListFloat | Mengatur nilai yang valid untuk properti WIA_PROP_LIST sub-VT_R4 jenis. |
| wiasSetValidListGuid | Mengatur nilai yang valid untuk properti WIA_PROP_LIST subjenis VT_CLSID. |
| wiasSetValidListLong | Mengatur nilai yang valid untuk properti WIA_PROP_LIST sub-VT_I4 jenis. |
| wiasSetValidListStr | Mengatur nilai yang valid untuk properti WIA_PROP_LIST sub-VT_BSTR jenis. |
| wiasSetValidRangeFloat | Menentukan rentang nilai yang valid untuk properti WIA_PROP_RANGE subjenis VT_R4. |
| wiasSetValidRangeLong | Menentukan rentang nilai yang valid untuk properti WIA_PROP_RANGE subjenis VT_I4. |
| wiasUpdateValidFormat | Updates format konteks properti yang valid untuk minidriver saat ini. |
| wiasValidateItemProperties | Memvalidasi daftar properti item sederhana terhadap nilainya yang valid saat ini. |
| wiasWriteMultiple | Menulis beberapa nilai properti ke item WIA (properti mungkin dari jenis yang berbeda). |
| wiasWritePropBin | Menulis satu nilai properti biner ke item WIA. |
| wiasWritePropFloat | Menulis nilai properti floating-point ke item WIA. |
| wiasWritePropGuid | Menulis nilai properti GUID ke item WIA. |
| wiasWritePropLong | Menulis nilai properti bilangan bulat panjang ke item WIA. |
| wiasWritePropStr | Menulis nilai properti string ke item WIA. |
Memperbarui dan mentransfer data
| Fungsi | Deskripsi |
|---|---|
| wiasDownSampleBuffer | Mengambil buffer data piksel dan downsampel ke ukuran yang ditentukan. |
| wiasGetImageInformation | Mengambil informasi konteks transfer dari item. |
| wiasParseEndorserString | Mengurai string yang mendukung, mengganti token yang ditentukan layanan WIA dan token yang ditentukan vendor dalam string dengan nilai yang terkait dengan token. |
| wiasSendEndOfPage | Memanggil rutinitas panggilan balik klien selama transfer data, mengirim jumlah halaman total saat ini. |
| wiasUpdateScanRect | Updates ukuran area pemindaian perangkat pemindaian. |
| wiasWriteBufToFile | Menulis isi buffer halaman sementara ke file gambar. |
| wiasWritePageBufToFile | Menulis isi buffer halaman sementara ke file gambar. Gunakan fungsi ini untuk menulis halaman ke file TIFF multi-halaman. |