共用方式為

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 會在驅動程式將IT_MSG_DEVICE_STATUS訊息傳送至BandedDataCallback時呼叫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