共用方式為


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