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 之前重置流。

Microsoft Windows SDK文档中介绍了 IStream、IWiaItem2IWiaPropertyStorage 接口。

要求

   
目标平台 桌面
Header wia_lh.h