Metode IWiaMiniDrv::d rvGetWiaFormatInfo (wiamindr_lh.h)
Metode IWiaMiniDrv::d rvGetWiaFormatInfo menemukan format gambar dan jenis media yang didukung perangkat keras WIA.
Sintaks
HRESULT drvGetWiaFormatInfo(
BYTE *__MIDL__IWiaMiniDrv0059,
LONG __MIDL__IWiaMiniDrv0060,
LONG *__MIDL__IWiaMiniDrv0061,
WIA_FORMAT_INFO **__MIDL__IWiaMiniDrv0062,
LONG *__MIDL__IWiaMiniDrv0063
);
Parameter
__MIDL__IWiaMiniDrv0059
lFlags [in]
Dicadangkan.
__MIDL__IWiaMiniDrv0060
pWiasContext [in]
Arahkan ke konteks item WIA.
__MIDL__IWiaMiniDrv0061
pcelt [out]
Menunjuk ke lokasi memori yang akan menerima jumlah item dalam array yang diarahkan oleh ppwfi.
__MIDL__IWiaMiniDrv0062
plDevErrVal [out]
Menunjuk ke lokasi memori yang akan menerima kode status untuk metode ini. Jika metode ini mengembalikan S_OK, nilai yang disimpan akan menjadi nol. Jika tidak, kode kesalahan khusus minidriver akan disimpan di lokasi yang ditujukkan oleh parameter ini.
__MIDL__IWiaMiniDrv0063
ppwfi [keluar, opsional]
Menunjuk ke lokasi memori yang akan menerima alamat elemen pertama dari array struktur WIA_FORMAT_INFO .
Mengembalikan nilai
Jika berhasil, metode harus mengembalikan S_OK dan menghapus nilai kesalahan perangkat yang ditunjukkan oleh plDevErrVal. Jika metode ini dipanggil untuk item yang tidak berisi data apa pun, metode ini harus mengembalikan E_INVALIDARG. Jika metode gagal, metode harus mengembalikan kode kesalahan COM standar dan menempatkan nilai kode kesalahan khusus minidriver dalam memori yang ditunjukkan oleh plDevErrVal.
Nilai yang ditujukkan oleh plDevErrVal dapat dikonversi ke string dengan memanggil IWiaMiniDrv::d rvGetDeviceErrorStr.
Keterangan
Metode ini membuat array struktur WIA_FORMAT_INFO yang menjelaskan jenis media dan format gambar yang didukung perangkat keras WIA. Untuk setiap elemen dalam array, jenis media dapat menjadi salah satu dari TYMED_CALLBACK, TYMED_MULTIPAGE_CALLBACK, TYMED_FILE, atau TYMED_MULTIPAGE_FILE. Nilai umum untuk format gambar termasuk WiaImgFmt_JPEG, dan WiaImgFmt_BMP, antara lain. Untuk informasi selengkapnya, lihat Memahami TYMED dan WIA_IPA_FILENAME_EXTENSION.
Minidriver dapat menentukan array global untuk menahan struktur WIA_FORMAT_INFO , atau dapat mengalokasikan memori untuk array. Layanan WIA tidak akan membebaskan memori yang dialokasikan, sehingga minidriver harus menyimpan pointer ke memori tersebut dalam konteks item driver. Minidriver kemudian dapat membebaskan memori ini dalam panggilan ke IWiaMiniDrv::d rvFreeDrvItemContext.
Persyaratan
| Persyaratan | Nilai |
|---|---|
| Target Platform | Desktop |
| Header | wiamindr_lh.h (termasuk Wiamindr.h) |