Metode IWiaSegmentationFilter::D etectRegions (wia_lh.h)
Metode IWiaSegmentationFilter::D etectRegions menentukan subregsi gambar yang ditata pada platen flatbed sehingga setiap subregion dapat diperoleh ke dalam item gambar terpisah.
Sintaks
HRESULT DetectRegions(
[in] LONG lFlags,
[in, optional] IStream *pInputStream,
[in, optional] IWiaItem2 *pWiaItem2
);
Parameter
[in] lFlags
Saat ini tidak digunakan. Harus diatur ke nol.
[in, optional] pInputStream
Menentukan penunjuk ke gambar pratinjau IStream .
[in, optional] pWiaItem2
Menentukan penunjuk ke item IWiaItem2 tempat pInputStream diperoleh. Filter segmentasi membuat item anak untuk item ini.
Nilai kembali
Mengembalikan S_OK jika berhasil, atau nilai kesalahan COM standar jika tidak.
Keterangan
Metode ini menentukan subregion gambar yang diwakili oleh pInputStream. Untuk setiap subregion yang dideteksinya, item ini membuat item anak untuk item IWiaItem2] yang diarahkan oleh parameter pWiaItem2 . Untuk setiap item anak, filter segmentasi harus mengatur nilai untuk persegi panjang batas area untuk dipindai, menggunakan properti item pemindai WIA berikut:
Filter yang lebih canggih mungkin juga memerlukan properti item pemindai lainnya, seperti WIA_IPS_DESKEW_X dan WIA_IPS_DESKEW_Y, jika driver mendukung deskewing.
Jika aplikasi memanggil IWiaSegmentationFilter::D etectRegions lebih dari sekali, aplikasi harus terlebih dahulu menghapus item anak yang dibuat oleh panggilan terakhir ke metode IWiaSegmentationFilter::D etectRegions .
Jika aplikasi mengubah properti apa pun menjadi pWiaItem2, antara memperoleh gambar ke pInputStream dan panggilannya ke IWiaSegmentationFilter::D etectRegions, pengaturan properti asli (pengaturan properti yang dimiliki item ketika aliran diperoleh) harus dipulihkan. Ini dapat dilakukan menggunakan IWiaPropertyStorage::GetPropertyStream dan IWiaPropertyStorage::SetPropertyStream.
Aplikasi harus mengatur ulang pratinjau IStream jika panggilannya melewati aliran yang sama ke filter segmentasi lebih dari sekali. Aplikasi juga harus mengatur ulang aliran setelah pengunduhan awal dan sebelum memanggil IWiaSegmentationFilter::D etectRegions.
Persyaratan
Persyaratan | Nilai |
---|---|
Target Platform | Desktop |
Header | wia_lh.h (termasuk Wia_lh.h) |