fungsi wiasReadPropBin (wiamdef.h)
Fungsi wiasReadPropBin mengambil nilai properti data biner dari item WIA.
Sintaks
HRESULT wiasReadPropBin(
[in] BYTE *pWiasContext,
PROPID propid,
[out] BYTE **ppbVal,
[out, optional] BYTE **ppbValOld,
BOOL bMustExist
);
Parameter
[in] pWiasContext
Arahkan ke konteks item WIA.
propid
Menentukan pengidentifikasi properti.
[out] ppbVal
Penunjuk ke lokasi memori yang menerima alamat buffer yang dialokasikan oleh fungsi ini. Setelah kembali, buffer berisi data biner properti.
[out, optional] ppbValOld
Penunjuk ke lokasi memori yang menerima alamat buffer yang dialokasikan oleh minidriver. Setelah kembali, buffer berisi nilai sebelumnya dari data biner properti. Jika informasi ini tidak diperlukan, parameter ini dapat diatur ke NULL.
bMustExist
Menunjukkan apakah properti harus ada. Jika diatur ke TRUE, properti harus ada; jika diatur ke FALSE, properti tidak harus ada.
Nilai kembali
Jika berhasil, fungsi mengembalikan S_OK.
Jika fungsi gagal, fungsi mengembalikan kesalahan COM standar atau salah satu kode kesalahan WIA.
Keterangan
Fungsi ini mengalokasikan buffer dan menyimpan alamatnya dalam parameter ppbVal . Minidriver harus membebaskan buffer dengan memanggil CoTaskMemFree.
Persyaratan
| Persyaratan | Nilai |
|---|---|
| Target Platform | Desktop |
| Header | wiamdef.h (termasuk Wiamdef.h) |
| Pustaka | Wiaservc.lib |
| DLL | Wiaservc.dll |