IWiaErrorHandler::ReportStatus 메서드

  • 아티클

이미지 데이터 전송 중에 상태 및 오류 메시지를 처리하고 사용자에게 표시합니다.

구문

HRESULT ReportStatus(
  [in] HWND     hwndParent,
  [in] IUnknown *punkItem,
  [in] HRESULT  hrStatus,
  [in] LONG     cbResLength,
  [in] BYTE     *pbData
);

매개 변수

hwndParent [in]

형식: HWND

메시지 창의 부모 창인 HWND입니다.

punkItem [in]

형식: IUnknown*

전송 중인 항목의 IUnknown 인터페이스에 대한 포인터입니다. 이 개체는 IWiaItem2 및 IWiaDataTransfer를 최소한으로 구현합니다.

hrStatus [in]

형식: HRESULT

BandedDataCallback에서 받은 상태 코드인 HRESULT입니다.

cbResLength [in]

형식: LONG

pbData에서 참조하는 데이터의 크기인 LONG입니다.

pbData [in]

형식: BYTE*

BandedDataCallback에서 받은 데이터 버퍼에 대한 포인터입니다.

반환 값

형식: HRESULT

오류를 복구할 수 없는 경우 hrStatus 를 반환합니다. 그렇지 않으면 다음 값 중 하나를 반환합니다.

반환 코드 Description
S_OK
 오류를 수정하기 위해 적절한 조치를 취했으며 전송을 계속할 수 있습니다.
S_FALSE
 오류를 처리하거나 사용자에게 상태 보고하는 작업이 수행되지 않았습니다.
E_ABORT
 사용자가 표시된 대화 상자에 대한 응답으로 전송을 중단하도록 선택했습니다.

 

설명

WIA(Windows Image Acquisition) 2.0은 드라이버가 BandedDataCallback에 IT_MSG_DEVICE_STATUS 메시지를 보낼 때 IWiaErrorHandler::ReportStatus를 호출합니다. 이 메서드는 메시지를 처리하고 상태 또는 오류에 대한 정보를 사용자에게 표시합니다. 메시지가 오류에 대한 경우 메서드를 사용하면 가능한 경우 오류에서 복구를 시도하고 전송을 계속할지 또는 중단할지를 선택할 수 있습니다.

hrStatus 는 처리기에 전송이 시작되었음을 알리기 위해 WIA_STATUS_TRANSFER_BEGIN 설정됩니다. 전송이 완료되면 WIA_STATUS_TRANSFER_END 설정됩니다.

hrStatus가 SEVERITY_SUCCESS 경우 사용자는 전송을 취소할 수 있어야 합니다.

요구 사항

요구 사항 값
지원되는 최소 클라이언트
 Windows Vista [데스크톱 앱만 해당]
지원되는 최소 서버
 Windows Server 2008 [데스크톱 앱만 해당]
헤더
Wia.h
IDL
Wia.idl
라이브러리
Wiaguid.lib