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 |
|---|---|
|
오류를 수정하기 위해 적절한 조치를 취했으며 전송을 계속할 수 있습니다. |
|
오류를 처리하거나 사용자에게 상태 보고하는 작업이 수행되지 않았습니다. |
|
사용자가 표시된 대화 상자에 대한 응답으로 전송을 중단하도록 선택했습니다. |
설명
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 [데스크톱 앱만 해당] |
| 헤더 |
|
| IDL |
|
| 라이브러리 |
|