Metode IWiaPreview::D etectRegions

Memanggil filter segmentasi driver dan meneruskan gambar yang tidak difilter yang di-cache oleh metode IWiaPreview::GetNewPreview ke filter.

Sintaks

HRESULT DetectRegions(
  [in] LONG lFlags
);

Parameter

lFlags [in]

Jenis: LONG

Tidak digunakan. Atur ke nol (0).

Menampilkan nilai

Jenis: HRESULT

Metode ini dapat mengembalikan salah satu nilai ini.

Menampilkan kode	Deskripsi
S_OK	Operasi berhasil.
E_NOTIMPL	Driver tidak mendukung segmentasi.
jika tidak	Kode kesalahan COM standar.

 

Keterangan

Aplikasi harus memanggil IWiaPreview::GetNewPreview sebelum memanggil fungsi ini.

Ketika Komponen Pratinjau Windows Image Acquisition (WIA) 2.0 memanggil IWiaPreview::D etectRegions, ia memanggil filter segmentasi driver dan melewati antarmuka IWiaItem2 yang sebelumnya diteruskan ke IWiaPreview::GetNewPreview. Ini juga meneruskan gambar yang di-cache secara internal ke filter. Filter segmentasi menggunakan gambar yang di-cache untuk membuat tingkat anak.

Jika aplikasi mengubah properti antarmuka IWiaItem2 setelah memanggil IWiaPreview::GetNewPreview, properti asli harus dipulihkan sebelum aplikasi memanggil IWiaPreview::D etectRegions. Gunakan GetPropertyStream dan SetPropertyStream untuk memulihkan properti asli.

IWiaPreview::D etectRegions digunakan untuk menentukan "sub-wilayah" dari gambar yang di-cache. Untuk setiap sub-wilayah yang terdeteksi, item WIA 2.0 anak baru dibuat di bawah antarmuka IWiaItem2 . Untuk setiap item anak, filter segmentasi harus mengatur nilai untuk properti WIA 2.0 berikut: WIA_IPS_XPOS, WIA_IPS_YPOS, WIA_IPS_XEXTENT, dan WIA_IPS_YEXTENT. Filter yang lebih canggih mengatur properti WIA 2.0 lainnya, seperti WIA_IPS_DESKEW_X dan WIA_IPS_DESKEW_Y, jika driver mendukung de-condong. Properti WIA_IPS_XPOS, WIA_IPS_YPOS, WIA_IPS_XEXTENT, dan WIA_IPS_YEXTENT mewakili persegi panjang batas area untuk dipindai.

Driver mungkin tidak mendukung segmentasi. Sebelum memanggil IWiaPreview::D etectRegions, aplikasi biasanya memeriksa apakah driver mendukung properti WIA_IPS_SEGMENTATION. Jika properti tidak diimplementasikan, segmentasi tidak didukung, dan IWiaPreview::D etectRegions gagal dan mengembalikan E_NOTIMPL.

Aplikasi harus membersihkan item anak yang dibuat dengan memanggil IWiaPreview::D etectRegions. Misalnya, jika aplikasi melakukan panggilan tambahan ke IWiaPreview::D etectRegions pada item yang sama, aplikasi harus membersihkan item anak sebelumnya.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows Vista [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2008 [hanya aplikasi desktop]
Header	Wia.h
IDL	Wia.idl