通过

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_XPOS

WIA_IPS_YPOS

WIA_IPS_XEXTENT

WIA_IPS_YEXTENT

如果驱动程序支持桌面，则更高级的筛选器可能还需要其他扫描程序项属性，例如 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）

另请参阅

IStream

IWiaItem2

IWiaPropertyStorage