fungsi wiasSetItemPropAttribs (wiamdef.h)
Fungsi wiasSetItemPropAttribs mengatur bendera akses dan nilai yang valid untuk sekumpulan properti item.
Sintaks
HRESULT wiasSetItemPropAttribs(
[in] BYTE *pWiasContext,
LONG cPropSpec,
[in] PROPSPEC *pPropSpec,
[in] PWIA_PROPERTY_INFO pwpi
);
Parameter
[in] pWiasContext
Arahkan ke konteks item WIA.
cPropSpec
Menentukan jumlah properti.
[in] pPropSpec
Penunjuk ke elemen pertama dari array struktur PROPSPEC (ditentukan dalam dokumentasi Microsoft Windows SDK) yang menunjukkan properti untuk mengatur nilai dan bendera akses yang valid.
[in] pwpi
Penunjuk ke elemen pertama dari array struktur WIA_PROPERTY_INFO yang berisi nilai properti yang akan ditulis.
Nilai kembali
Setelah berhasil, fungsi mengembalikan S_OK. Jika fungsi gagal, fungsi mengembalikan kesalahan COM standar atau salah satu kesalahan WIA_ERROR_XXX (dijelaskan dalam dokumentasi Windows SDK).
Keterangan
Minidriver harus menggunakan fungsi ini untuk menginisialisasi grup properti sederhana. Grup properti dapat berupa bitset, rentang nilai, atau daftar nilai. Jenis sederhana yang didukung, dikelompokkan menurut atribut adalah sebagai berikut.
| Atribut | Jenis yang didukung |
|---|---|
| WIA_PROP_FLAG | VT_UI1, VT_UI2, VT_UI4, VT_UI8, VT_I1, VT_I2, VT_I4, VT_I8 |
| WIA_PROP_RANGE | VT_UI1, VT_UI2, VT_UI4, VT_UI8, VT_I1, VT_I2, VT_I4, ,VT_I8, VT_R4, VT_R8 |
| WIA_PROP_LIST | VT_UI1, VT_UI2, VT_UI4, VT_UI8, VT_I1, VT_I2, VT_I4, ,VT_I8, VT_R4, VT_R8, VT_BSTR |
Minidriver harus menginisialisasi properti kompleks menggunakan fungsi wiasSetPropertyAttributes .
Minidriver dapat mengatur bendera WIA_PROP_CACHEABLE pada properti yang tidak berubah dari waktu ke waktu. Dengan mengatur bendera ini pada properti, minidriver menunjukkan bahwa layanan WIA dapat menyimpan nilai properti. Lihat dokumentasi Windows SDK untuk daftar semua atribut properti.
Penting untuk diingat bahwa wiasSetItemPropAttribs mengembalikan HRESULT, bukan BOOLEAN. Misalnya, jika wiasSetItemPropAttribs mengembalikan 0, nilai ini harus ditafsirkan sebagai S_OK daripada FALSE, dan menunjukkan bahwa semuanya berfungsi seperti yang diharapkan. Jika wiasSetItemPropAttribs mengembalikan S_FALSE HRESULT, ini menunjukkan bahwa salah satu properti yang Anda coba atur mungkin tidak ada di aliran properti.
Untuk mendapatkan log wiadebug dari kesalahan ini, buka registri dan aktifkan pengelogan WIA untuk Peringatan dan Kesalahan. Kunci registri untuk ini adalah: HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\StillImage\Debug\wiaservc.dll
Atur nilai "DebugFlags." ke 0x00000003
Reboot sistem dan ulangi langkah-langkah yang diperlukan untuk menghasilkan kesalahan ini. Sekarang akan ada file bernama "wiadebug.log" di direktori %windir%.
Persyaratan
| Persyaratan | Nilai |
|---|---|
| Target Platform | Desktop |
| Header | wiamdef.h (termasuk Wiamdef.h) |
| Pustaka | Wiaservc.lib |
| DLL | Wiaservc.dll |