fungsi wiasGetImageInformation (wiamdef.h)
Fungsi wiasGetImageInformation mengambil informasi konteks transfer dari item.
Sintaks
HRESULT wiasGetImageInformation(
[in] BYTE *pWiasContext,
LONG lFlags,
[in, out] PMINIDRV_TRANSFER_CONTEXT pmdtc
);
Parameter
[in] pWiasContext
Arahkan ke konteks item WIA.
lFlags
Menentukan bendera operasional. Saat ini, hanya bendera berikut yang ditentukan:
| Bendera | Makna |
|---|---|
| WIAS_INIT_CONTEXT | Menginisialisasi struktur MINIDRV_TRANSFER_CONTEXT. |
[in, out] pmdtc
Penunjuk ke struktur MINIDRV_TRANSFER_CONTEXT . Setelah kembali, struktur ini berisi informasi item gambar yang diminta.
Mengembalikan nilai
Jika berhasil, fungsi mengembalikan S_OK.
Jika fungsi gagal, fungsi mengembalikan kesalahan COM standar atau salah satu kode kesalahan WIA.
Keterangan
Fungsi ini menggunakan struktur MINIDRV_TRANSFER_CONTEXT untuk menghitung gambar item dan ukuran header item. Selain itu, secara opsional dapat mengisi header gambar jika format gambar memerlukan header data. Header akan disalin ke buffer jika anggota pTransferBuffer dari struktur MINIDRV_TRANSFER_CONTEXT bukan NULL. Saat menggunakan format gambar (seperti JPEG) yang tidak memiliki header, ukuran header dalam anggota lHeaderSize dari struktur MINIDRV_TRANSFER_CONTEXT dilaporkan sebagai nol.
Untuk format gambar di mana ukuran akhir gambar aktual tidak diketahui sampai setelah akuisisi data, seperti halnya TIFF multihalaman dan format terkompresi, anggota lItemSize dari struktur MINIDRV_TRANSFER_CONTEXT dilaporkan sebagai nol. Anggota lImageSize dilaporkan sebagai ukuran, dalam byte, dari gambar yang tidak dikompresi dalam satu halaman.
Jika WIAS_INIT_CONTEXT ditentukan dalam parameter lFlags , struktur MINIDRV_TRANSFER_CONTEXT yang ditunjukkan oleh parameter pmdtc diisi dengan informasi yang berasal dari properti gambar item. Bendera ini harus digunakan ketika minidriver telah mengalokasikan konteks baru.
Persyaratan
| Persyaratan | Nilai |
|---|---|
| Target Platform | Desktop |
| Header | wiamdef.h (termasuk Wiamdef.h) |
| Pustaka | Wiaservc.lib |
| DLL | Wiaservc.dll |