Метод 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

HRESULT — код состояния, полученный BandedDataCallback.

cbResLength [in]

Тип: LONG

LONG , то есть размер данных, на которые ссылается pbData.

pbData [in]

Тип: BYTE*

Указатель на буфер данных, полученный с помощью BandedDataCallback.

Возвращаемое значение

Тип: HRESULT

Возвращает hrStatus, если ошибка не может быть восстановлена. В противном случае возвращается одно из следующих значений.

Код возврата	Описание
S_OK	Для исправления ошибки было предприняно соответствующее действие, и передача может продолжиться.
S_FALSE	Никаких действий по обработке ошибки или отчета о состоянии пользователю не предпринималось.
E_ABORT	Пользователь решил прервать передачу в ответ на отображаемое диалоговое окно.

 

Комментарии

Windows Image Acquisition (WIA) 2.0 вызывает IWiaErrorHandler::ReportStatus , когда драйвер отправляет IT_MSG_DEVICE_STATUS сообщение в BandedDataCallback. Этот метод обрабатывает сообщение и отображает пользователю сведения о состоянии или ошибке. Если сообщение содержит сообщение об ошибке, метод позволяет пользователю, если это возможно, выбрать, следует ли попытаться восстановить ошибку и продолжить передачу или прервать.

Для hrStatus задано значение WIA_STATUS_TRANSFER_BEGIN, чтобы сообщить обработчику о начале передачи. После завершения передачи задано значение WIA_STATUS_TRANSFER_END.

Если параметр hrStatus SEVERITY_SUCCESS, пользователю должно быть разрешено отменить передачу.

Требования

Требование	Значение
Минимальная версия клиента	Windows Vista [только классические приложения]
Минимальная версия сервера	Windows Server 2008 [только классические приложения]
Заголовок	Wia.h
IDL	Wia.idl
Библиотека	Wiaguid.lib