共用方式為

IWiaPreview：:D etectRegions 方法

  • 發行項

叫用驅動程式分割篩選，並將 IWiaPreview：：GetNewPreview 方法快取的未篩選映射傳遞至篩選。

語法

HRESULT DetectRegions(
  [in] LONG lFlags
);

參數

lFlags [in]

類型： LONG

未使用。 設定為零 (0) 。

傳回值

類型： HRESULT

這個方法可以傳回其中一個值。

傳回碼 描述
S_OK
 作業成功。
E_NOTIMPL
 驅動程式不支援分割。
否則
 標準 COM 錯誤碼。

 

備註

應用程式必須先呼叫 IWiaPreview：：GetNewPreview ，才能呼叫此函式。

當 Windows 映像擷取 (WIA) 2.0 預覽元件呼叫IWiaPreview：:D etectRegions時，它會叫用驅動程式分割篩選，並傳遞先前傳遞至IWiaPreview：：GetNewPreview的IWiaItem2介面。 它也會將內部快取的映射傳遞至篩選。 分割篩選會使用快取的影像來建立子範圍。

如果應用程式在呼叫IWiaPreview：：GetNewPreview之後變更IWiaItem2介面的任何屬性，則必須在應用程式呼叫IWiaPreview：:D etectRegions之前還原原始屬性。 使用 GetPropertyStream 和 SetPropertyStream 還原原始屬性。

IWiaPreview：:D etectRegions 可用來判斷快取映射的「子領域」。 針對偵測到的每個子領域，會在 IWiaItem2 介面下建立新的子 WIA 2.0 專案。 針對每個子專案，分割篩選必須設定下列 WIA 2.0 屬性的值：WIA_IPS_XPOS、WIA_IPS_YPOS、WIA_IPS_XEXTENT和WIA_IPS_YEXTENT。 如果驅動程式支援反扭曲，則更進階的篩選會設定其他 WIA 2.0 屬性，例如WIA_IPS_DESKEW_X和WIA_IPS_DESKEW_Y。 WIA_IPS_XPOS、WIA_IPS_YPOS、WIA_IPS_XEXTENT和WIA_IPS_YEXTENT屬性代表要掃描的區域周框。

驅動程式可能不支援分割。 呼叫 IWiaPreview：:D etectRegions之前，應用程式通常會檢查驅動程式是否支援 WIA_IPS_SEGMENTATION 屬性。 如果未實作屬性，則不支援分割，且 IWiaPreview：:D etectRegions 會失敗並傳回E_NOTIMPL。

應用程式必須清除透過呼叫 IWiaPreview：:D etectRegions所建立的子專案。 例如，如果應用程式對相同專案的 IWiaPreview：:D etectRegions 進行其他呼叫，則必須清除先前的子專案。

規格需求

需求 值
最低支援的用戶端
 Windows Vista [僅限傳統型應用程式]
最低支援的伺服器
 Windows Server 2008 [僅限傳統型應用程式]
標頭
Wia.h
Idl
Wia.idl