共用方式為

IWiaEventCallback：：ImageEventCallback 方法 (wia_xp.h)

  • 發行項

當硬體裝置事件發生時，Windows 映像下載 (WIA) 執行時間系統會叫用 IWiaEventCallback：：ImageEventCallback 方法。

語法

HRESULT ImageEventCallback(
  [in]      const GUID *pEventGUID,
  [in]      BSTR       bstrEventDescription,
  [in]      BSTR       bstrDeviceID,
  [in]      BSTR       bstrDeviceDescription,
  [in]      DWORD      dwDeviceType,
  [in]      BSTR       bstrFullItemName,
  [in, out] ULONG      *pulEventType,
  [in]      ULONG      ulReserved
);

參數

[in] pEventGUID

類型： const GUID*

指定事件的唯一識別碼。 如需裝置事件的完整清單，請參閱 WIA 事件識別碼。

[in] bstrEventDescription

類型： BSTR

指定事件的字串描述。

[in] bstrDeviceID

類型： BSTR

指定 WIA 裝置的唯一識別碼。

[in] bstrDeviceDescription

類型： BSTR

指定裝置的字串描述。

[in] dwDeviceType

類型： DWORD

指定裝置的類型。 如需可能值的清單，請參閱 WIA 裝置類型規範 。

[in] bstrFullItemName

類型： BSTR

指定代表裝置之 WIA 專案的完整名稱。

[in, out] pulEventType

類型： ULONG*

ULONG的指標，指定事件是否為通知事件、動作事件或兩者。 值為 1 表示通知事件、值為 2 表示動作事件，而值為 3 表示事件同時屬於通知和動作類型。

[in] ulReserved

類型： ULONG

保留給使用者資訊。

傳回值

類型： HRESULT

如果此方法成功，則會傳回 S_OK。 否則，它會傳回 HRESULT 錯誤碼。

備註

若要接收 WIA 硬體裝置事件的通知，應用程式會將 IWiaEventCallback 介面的指標傳遞至 RegisterEventCallbackInterface 方法。 WIA 執行時間系統接著會使用該介面指標在發生 WIA 硬體裝置事件時叫用 IWiaEventCallback：：ImageEventCallback 方法。

請注意，在註冊 IWiaEventCallback 介面的相同執行緒上，不會保證會叫用回呼。

規格需求

   
最低支援的用戶端 Windows 2000 專業版、Windows XP [僅限傳統型應用程式]
最低支援的伺服器 Windows Server 2003 [僅限傳統型應用程式]
目標平台 Windows
標頭 wia_xp.h (包括 Wia.h)
程式庫 Wiaguid.lib