IWiaPreview::D etectRegions 메서드
드라이버 구분 필터를 호출하고 IWiaPreview::GetNewPreview 메서드에 의해 캐시된 필터링되지 않은 이미지를 필터에 전달합니다.
HRESULT DetectRegions(
[in] LONG lFlags
);
-
lFlags [in]
-
형식: LONG
사용되지 않습니다. 0으로 설정합니다.
형식: HRESULT
이 메서드는 이러한 값 중 하나를 반환할 수 있습니다.
반환 코드 | 설명 |
---|---|
|
작업에 성공했습니다. |
|
드라이버는 구분을 지원하지 않습니다. |
|
표준 COM 오류 코드입니다. |
애플리케이션은 이 함수를 호출하기 전에 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를 추가로 호출하는 경우 이전 자식 항목을 클린 합니다.
요구 사항 | 값 |
---|---|
지원되는 최소 클라이언트 |
Windows Vista [데스크톱 앱만 해당] |
지원되는 최소 서버 |
Windows Server 2008 [데스크톱 앱만 해당] |
헤더 |
|
IDL |
|