IWiaSegmentationFilter::D etectRegions 方法 (wia_lh.h)
IWiaSegmentationFilter::D etectRegions 方法确定平面上布局的图像的子区域,以便可以将每个子区域获取到单独的图像项中。
语法
HRESULT DetectRegions(
[in] LONG lFlags,
[in, optional] IStream *pInputStream,
[in, optional] IWiaItem2 *pWiaItem2
);
参数
[in] lFlags
当前未使用。 应设置为零。
[in, optional] pInputStream
指定指向 IStream 预览图像的指针。
[in, optional] pWiaItem2
指定指向为其获取 pInputStream 的 IWiaItem2 项的指针。 分段筛选器为此项创建子项。
返回值
如果成功,则返回S_OK,否则返回标准 COM 错误值。
注解
此方法确定 pInputStream 表示的图像的子区域。 对于它检测到的每个子区域,它会为 pWiaItem2 参数指向的 IWiaItem2 ] 项创建一个子项。 对于每个子项,分段筛选器必须使用以下 WIA 扫描程序项属性为要扫描的区域的边界矩形设置值:
如果驱动程序支持倾斜,则更高级的筛选器可能还需要其他扫描程序项属性,例如 WIA_IPS_DESKEW_X 和 WIA_IPS_DESKEW_Y。
如果应用程序多次调用 IWiaSegmentationFilter::D etectRegions ,则应用程序必须首先删除上次调用 IWiaSegmentationFilter::D etectRegions 方法创建的子项。
如果应用程序将任何属性更改为 pWiaItem2,在将图像获取到 pInputStream 和调用 IWiaSegmentationFilter::D etectRegions 之间,必须还原原始属性设置 (获取流时项具有的属性设置) 。 可以使用 IWiaPropertyStorage::GetPropertyStream 和 IWiaPropertyStorage::SetPropertyStream 完成此操作。
如果应用程序调用多次将相同的流传递到分段筛选器中,则应用程序必须重置 IStream 预览。 应用程序还必须在初始下载后和调用 IWiaSegmentationFilter::D etectRegions 之前重置流。
要求
要求 | 值 |
---|---|
目标平台 | 桌面 |
标头 | wia_lh.h (包括 Wia_lh.h) |