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

指定指向为其获取 pInputStreamIWiaItem2 项的指针。 分段筛选器为此项创建子项。

返回值

如果成功,则返回S_OK,否则返回标准 COM 错误值。

注解

此方法确定 pInputStream 表示的图像的子区域。 对于它检测到的每个子区域,它会为 pWiaItem2 参数指向的 IWiaItem2 ] 项创建一个子项。 对于每个子项,分段筛选器必须使用以下 WIA 扫描程序项属性为要扫描的区域的边界矩形设置值:

WIA_IPS_XPOS

WIA_IPS_YPOS

WIA_IPS_XEXTENT

WIA_IPS_YEXTENT

如果驱动程序支持倾斜,则更高级的筛选器可能还需要其他扫描程序项属性,例如 WIA_IPS_DESKEW_XWIA_IPS_DESKEW_Y

如果应用程序多次调用 IWiaSegmentationFilter::D etectRegions ,则应用程序必须首先删除上次调用 IWiaSegmentationFilter::D etectRegions 方法创建的子项。

如果应用程序将任何属性更改为 pWiaItem2,在将图像获取到 pInputStream 和调用 IWiaSegmentationFilter::D etectRegions 之间,必须还原原始属性设置 (获取流时项具有的属性设置) 。 可以使用 IWiaPropertyStorage::GetPropertyStreamIWiaPropertyStorage::SetPropertyStream 完成此操作。

如果应用程序调用多次将相同的流传递到分段筛选器中,则应用程序必须重置 IStream 预览。 应用程序还必须在初始下载后和调用 IWiaSegmentationFilter::D etectRegions 之前重置流。

要求

要求
目标平台 桌面
标头 wia_lh.h (包括 Wia_lh.h)

另请参阅

IStream

IWiaItem2

IWiaPropertyStorage