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) |