IWiaPreview::D etectRegions 메서드

드라이버 구분 필터를 호출하고 IWiaPreview::GetNewPreview 메서드에 의해 캐시된 필터링되지 않은 이미지를 필터에 전달합니다.

구문

HRESULT DetectRegions(
  [in] LONG lFlags
);

매개 변수

lFlags [in]

형식: LONG

사용되지 않습니다. 0으로 설정합니다.

반환 값

형식: HRESULT

이 메서드는 이러한 값 중 하나를 반환할 수 있습니다.

설명

애플리케이션은 이 함수를 호출하기 전에 IWiaPreview::GetNewPreview 를 호출해야 합니다.

WIA(Windows 이미지 획득) 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_IPS_DESKEW_X 및 WIA_IPS_DESKEW_Y 같은 다른 WIA 2.0 속성을 설정합니다. 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를 추가로 호출하는 경우 이전 자식 항목을 클린 합니다.

요구 사항